home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / BUSINESS / ASA501D.ARJ / ASEASY5.FLS / ASEASY.MAN < prev    next >
Text File  |  1992-05-22  |  223KB  |  5,901 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                                 (tm)
  12.                                     AS-EASY-AS...
  13.                                     Version  5.01
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                                    USER'S MANUAL
  22.                                    ~~~~~~~~~~~~~
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                                      TRIUS, Inc.
  31.                                     P.O. Box 249
  32.                             N. Andover, MA  01845-0249
  33.  
  34.                                  Tel. (508) 794-9377
  35.                                  Fax. (508) 688-6312
  36.                                  BBS  (508) 794-0762
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.                          Copyright 1985 - 1992, TRIUS, Inc.
  47.                            All Rights Reserved Worldwide
  48.  
  49.       +-------------------------------------------------------------------+
  50.       | This document is for evaluating the Shareware copy of AS-EASY-AS! |
  51.       |   Use of the software package and this document beyond a 30-day   |
  52.       |             evaluation period requires registration!              |
  53.       |             ----------------------------------------              |
  54.       |    Distribution of printed copies of this manual is Prohibited!   |
  55.       +-------------------------------------------------------------------+
  56.  
  57.  
  58.     COPYRIGHT NOTICE
  59.     ~~~~~~~~~~~~~~~~
  60.     AS-EASY-AS(tm) is a copyrighted software product developed and owned
  61.     by TRIUS, Inc. located in North Andover, Massachusetts, U.S.A.
  62.  
  63.     You may make and keep back-up copies of the software for your personal
  64.     use, provided that you copy all the copyright, trademark, and other
  65.     information indicated on the initial screen display, on each backup
  66.     copy label.
  67.  
  68.     The rights to receive any financial or other benefit, and to modify
  69.     the product or employ its components in any kind of derivative work,
  70.     are reserved exclusively by TRIUS, Inc.
  71.  
  72.     You may not reverse-engineer, disassemble, modify, decompile or create
  73.     derivative works of the product.  You acknowledge that the product
  74.     includes certain trade secrets and confidential information, all of
  75.     which is the copyrighted intellectual property of TRIUS, Inc.
  76.  
  77.     AS-EASY-AS is a trademark of TRIUS Inc. and the TRIUS Logo is a
  78.     trademark of TRIUS, Inc.  All rights are reserved worldwide.
  79.  
  80.     The AS-EASY-AS User's Manual is copyrighted and all rights are
  81.     reserved. The reproduction of this document, in whole or part, its
  82.     conversion to electronic medium or its distribution in printed form
  83.     (hard copy) are prohibited unless prior consent, in writing, has been
  84.     given by TRIUS, Inc.
  85.  
  86.         EPSON is a trademark of Epson America Inc.
  87.         IBM is a trademark of International Business Machines, Inc.
  88.         LOTUS 1-2-3 is a trademark of Lotus Development Corporation
  89.         HERCULES is a trademark of Hercules Corporation
  90.         MS-DOS is a trademark of Microsoft Corporation.
  91.         SYMPHONY is a trademark of Lotus Development Corporation
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [2] 
  117.     LIMITED WARRANTY
  118.     ~~~~~~~~~~~~~~~~
  119.     This program is provided on an "as is" basis without warranty of any
  120.     kind, expressed or implied, including but not limited to the implied
  121.     warranties of merchantability and fitness for a particular purpose.
  122.     The entire risk as to quality and performance of these programs is
  123.     with you.  Should the program prove defective, you (not TRIUS, Inc.)
  124.     assume the entire cost of all necessary repair, servicing, or
  125.     correction.  In no event will TRIUS, Inc. be liable to you for any
  126.     damages, including any lost profits, lost savings, or other incidental
  127.     or consequential damages arising out of the use or inability to use
  128.     these programs, even if TRIUS, Inc. has been advised of the
  129.     possibility  of such damages.  This warranty gives you specific legal
  130.     rights, and you may also have other rights which vary from state to
  131.     state.  Some states do not allow the exclusion of implied warranties
  132.     or exclusion of liability for incidental or consequential damages so
  133.     the above may not apply to you.  You acknowledge that you have read
  134.     this agreement, understand it, and agree to be bound by its terms and
  135.     conditions.  You further agree that it is the complete and exclusive
  136.     statement of the  agreement between us, which supersedes any proposal
  137.     or prior agreement, oral or written, and any other communications
  138.     between us.
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [3] 
  176.  
  177.     TABLE OF CONTENTS                                                    Page
  178.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  179.     COPYRIGHT NOTICE....................................................   2
  180.     LIMITED WARRANTY....................................................   3
  181.     1. INTRODUCTION.....................................................   6
  182.        WHAT IS A SPREADSHEET............................................   7
  183.     2. OPERATING REQUIREMENTS...........................................   7
  184.        PROGRAM INSTALLATION.............................................   8
  185.        MOUSE INTERFACE..................................................   8
  186.        STARTING THE PROGRAM.............................................  10
  187.        COMMAND LINE SWITCHES............................................  10
  188.        STARTING AS-EASY-AS FROM ANY DIRECTORY...........................  12
  189.        MENUS............................................................  13
  190.        VIEWS/WINDOWS....................................................  15
  191.        SMART CURSOR.....................................................  17
  192.        FUNCTION KEYS....................................................  17
  193.     3. BASICS...........................................................  20
  194.        ENTERING LABELS..................................................  20
  195.        ENTERING VALUES..................................................  20
  196.        ENTERING FORMULAS................................................  21
  197.        ENTERING GRAPHICS CHARACTERS.....................................  21
  198.        EDITING A CELL...................................................  22
  199.        METHODS FOR ENTERING FORMULAS....................................  22
  200.        WHAT IS A RANGE..................................................  23
  201.        DEFINING A RANGE.................................................  24
  202.        POINTING WITH THE ARROW KEYS.....................................  24
  203.        POINTING WITH THE MOUSE..........................................  24
  204.        TYPING...........................................................  25
  205.        NAMING A RANGE...................................................  25
  206.        SETTING FORMATS..................................................  26
  207.        WHY DO YOU NEED FORMATS?.........................................  26
  208.        RELATIVE VERSUS ABSOLUTE ADDRESSES...............................  26
  209.        COPY VALUES......................................................  28
  210.        MOVE VALUES......................................................  28
  211.        MOVE FORMULAS....................................................  29
  212.        RECALCULATION MODES..............................................  29
  213.        CIRCULAR REFERENCES..............................................  30
  214.        SAVING THE WORKSHEET.............................................  30
  215.        Saving PART OF THE WORKSHEET.....................................  31
  216.        RETRIEVING THE WORKSHEET.........................................  32
  217.        COMBINING WORKSHEETS.............................................  32
  218.        LEAVING THE WORKSHEET                                              32
  219.     4. PRINTING.........................................................  34
  220.        PRINTER BORDERS..................................................  35
  221.        MARGINS & PAGE LENGTH - PRINTER OPTIONS..........................  35
  222.        PRINTER OPTIONS - HEADERS & FOOTERS..............................  37
  223.        PRINTER OPTIONS - EMBEDDED CODES.................................  38
  224.        PRINTER OPTIONS - TYPE...........................................  38
  225.        CONTROLLING THE PRINTER..........................................  39
  226.        ASEASY.PRT.......................................................  39
  227.        PRINT TO A FILE..................................................  40
  228.        PRINTING COMBINED TEXT AND GRAPHICS..............................  41
  229.        USING PRINT VIEW.................................................  41
  230.  
  231.  
  232.  
  233.  
  234.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [4] 
  235.  
  236.     5. GRAPHICS COMMANDS................................................  42
  237.        GRAPH RANGES.....................................................  42
  238.        FORMAT...........................................................  42
  239.        OPTIONS..........................................................  43
  240.        CUSTOM...........................................................  43
  241.        COMBINING TEXT AND GRAPHICS......................................  46
  242.        SAVING A GRAPH...................................................  46
  243.     6. DATA COMMANDS....................................................  48
  244.        DATA FILL........................................................  48
  245.        DATA TABLE.......................................................  48
  246.        DATA TABLE - 1 INPUT.............................................  48
  247.        DATA TABLE - 2 INPUTS............................................  49
  248.        DATA SORT........................................................  49
  249.        DATA BIN.........................................................  50
  250.        DATA GOAL SEEK...................................................  50
  251.        DATA REGRESSION..................................................  51
  252.        DATA INPUT RANGE.................................................  52
  253.        DATA INPUT FORM..................................................  52
  254.     7. DATABASE OPERATIONS..............................................  54
  255.        INPUT RANGE......................................................  54
  256.        CRITERION RANGE..................................................  54
  257.        OUTPUT RANGE.....................................................  55
  258.     8. MATRIX OPERATIONS................................................  56
  259.        MATRIX EQUATION..................................................  57
  260.     9. FUNCTIONS........................................................  58
  261.        STRING FUNCTIONS.................................................  58
  262.        MATH FUNCTIONS...................................................  64
  263.        FINANCIAL FUNCTIONS..............................................  67
  264.        LOGICAL FUNCTIONS................................................  71
  265.        STATISTICAL FUNCTIONS............................................  73
  266.        SPECIAL FUNCTIONS................................................  76
  267.        DATE AND TIME FUNCTIONS..........................................  80
  268.     10.MACROS...........................................................  83
  269.        DEFINING A MACRO.................................................  83
  270.        EXECUTING A MACRO................................................  84
  271.        MACRO MENU ESCAPE SEQUENCE.......................................  84
  272.        MACRO KEYWORDS...................................................  84
  273.        ADVANCED MACROS..................................................  85
  274.  
  275.        INDEX............................................................  97
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [5] 
  294.     1. INTRODUCTION
  295.     ~~~~~~~~~~~~~~~
  296.     Thank you for trying out AS-EASY-AS, an excellent spreadsheet program,
  297.     packed with features that can't be found in other packages that cost
  298.     many times more.  Before you rest your fingers on the keyboard and
  299.     start using AS-EASY-AS, its useful to have an overview of the
  300.     capabilities of the program.  Of course, the list below represents
  301.     just a sampling of the many features.  However, it will give you an
  302.     idea of the versatility of AS-EASY-AS:
  303.  
  304.     *  Large size (8,192 Rows by 256 Columns)
  305.     *  Pull Down Menu Interface
  306.     *  Math, Statistical, Logical, Financial, String, Date, Time
  307.         and User Functions
  308.     *  Matrix Operations, Frequency Distribution Tables (Bins)
  309.     *  File Linking
  310.     *  Powerful Graphics
  311.     *  Bar, Line, X-Y, Pie, Stacked Bar, Hi-Lo, Polar, Area, Delta,
  312.        Cumulative, Strip, Wall, Semi-Log, and Log-Log Graphs
  313.     *  X-Y Data Regression
  314.     *  Keyboard and Mouse-based Operation
  315.     *  Preview Mode With Combined Text and Graphics
  316.     *  9/24-pin dot matrix pin, HP Laserjet and HP Pen Plotter Support
  317.     *  Windows!  Up to six resizeable and moveable spreadsheet views
  318.     *  Database Operations, Data Input Forms, Read/Write dBASE Files
  319.     *  Text Search, Replace, Justify
  320.     *  Goalseeking - Desire an answer? Let the computer solve for the input
  321.         value!
  322.     *  User-configurable Printer Setup File
  323.     *  Spreadsheet Auditing Capabilities
  324.     *  Named Range, Function, Macro Selection Lists
  325.     *  Multiple Planes (3-D Simulation)
  326.     *  Macro Programming Language (over 70 powerful macros)
  327.     *  Macro Record/Playback Capability and Single Stepping Through Macros
  328.     *  File Manager
  329.     *  Support of Hercules/CGA/EGA/AT&T/, and VGA graphics cards
  330.     *  Shell to DOS, TRIUS Add-ins, and much, much more .......
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [6] 
  353.     2.  OPERATING REQUIREMENTS
  354.     ~~~~~~~~~~~~~~~~~~~~~~~~~~
  355.     HARDWARE
  356.      AS-EASY-AS is designated to operate on any IBM PC, XT, AT, PS/2 or
  357.      fully compatible computer, as described below:
  358.  
  359.     OPERATING SYSTEM
  360.      AS-EASY-AS will operate using DOS Version 2.11 or later.  It has also
  361.      been tested and works under Windows 3.0 as a DOS application.
  362.  
  363.     MEMORY REQUIREMENTS
  364.      384k minimum RAM.  Spreadsheet data is stored using a sparse matrix
  365.      technique which only allocates space required by each cell.
  366.  
  367.      Expanded Memory is automatically detected and used by AS-EASY-AS.
  368.      If you don't have EMS, you can instruct AS-EASY-AS to use Virtual
  369.      Memory, whereby a hard disk or diskette may be used to emulate EMS.
  370.      If you don't have EMS memory and don't use virtual memory, only
  371.      conventional DOS memory will be used.
  372.  
  373.     DISK DRIVE
  374.      The minimum files required to run AS-EASY-AS are listed in Section
  375.      2 and require less than 360 KB of disk space.  As a result, AS-
  376.      EASY-AS will run on single floppy (720K minimum), dual floppy, or
  377.      hard disk system.  This enables AS-EASY-AS to run on older PCs and
  378.      laptops without hard disks.
  379.  
  380.     VIDEO CARD/MONITOR
  381.      MONOCHROME  - 80x25 text resolution.
  382.      HERCULES - 720x348 resolution.
  383.      COLOR GRAPHICS ADAPTER (CGA) - 640x200 resolution.
  384.      ENHANCED GRAPHICS ADAPTER (EGA) - 640x350 resolution.
  385.      VIDEO GRAPHICS ARRAY (VGA) - 640x480 resolution.
  386.  
  387.     PRINTERS
  388.      AS-EASY-AS will print text and graphics to Epson and compatible 9/24-
  389.      and, Okidata 24-pin dot matrix printers and Hewlett Packard LaserJet
  390.      II and compatible laserjet printers.  It will also work with daisy
  391.      wheel printers, but they will not be able to print graphics.
  392.  
  393.     MOUSE
  394.      AS-EASY-AS may optionally be used with a Microsoft or compatible
  395.      mouse.
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [7] 
  412.     PROGRAM INSTALLATION
  413.     ~~~~~~~~~~~~~~~~~~~~
  414.     Before using AS-EASY-AS, we recommend that a working copy of the
  415.     program be made either on your hard disk or on a separate floppy
  416.     diskette. An installation program provided on the AS-EASY-AS diskette
  417.     makes the process simple.  It will transfer the necessary files from
  418.     the original diskette to your working disk/directory.  There are no copy
  419.     protection schemes or hidden files to wrestle with.
  420.  
  421.     If you are making a working disk, first format two blank diskettes and
  422.     label them AS-EASY-AS #1 and #2.
  423.  
  424.     To make a working copy of the program:
  425.  
  426.      1.  Place the AS-EASY-AS program disk in drive A:
  427.      2.  At the DOS prompt, type A: and press [ENTER]
  428.      3.  Type INSTALL and press [ENTER].
  429.  
  430.     Follow the simple on-screen instructions to specify where to install
  431.     the program.  If you are installing the program on a 360K diskette,
  432.     you will get a message that some file(s) will not fit on the disk.  To
  433.     extract the rest of the files, use an additional disk and start the
  434.     program with the /p command line switch, i.e., INSTALL /p [ENTER].
  435.  
  436.     When the operation is complete, the DOS prompt will reappear on your
  437.     screen.  Place the original diskette in a safe place.  If your working
  438.     diskette later becomes damaged, repeat the above process to make a new
  439.     working disk.
  440.  
  441.     The following files are the minimum required to run AS-EASY-AS:
  442.  
  443.         ASEASY.EXE          ASEASY.MSG         ASEASY.MNU
  444.  
  445.     The rest of the files do not need to be present in your working
  446.     disk/directory to run the program.
  447.  
  448.  
  449.     MOUSE INTERFACE
  450.     ~~~~~~~~~~~~~~~
  451.      AS-EASY-AS may be used with a Microsoft or compatible 2 or 3 button
  452.      mouse.  Some mice have three buttons, while others have two.  AS-
  453.      EASY-AS uses only two buttons on the mouse.  The left button is
  454.      functionally equivalent to the [ENTER] key on the keyboard, and the
  455.      middle and/or right mouse buttons both represent the [ESC] key.  You
  456.      can use the keyboard and mouse equivalents interchangeably.
  457.  
  458.      In text modes, the mouse cursor appears on the AS-EASY-AS screen as a
  459.      block one character in width and height.  The cursor may be moved
  460.      around the screen through corresponding movement of the mouse.
  461.  
  462.      If the left mouse button is "tapped" or "clicked" while on a
  463.      worksheet cell, the worksheet cell pointer will relocate to the cell
  464.      occupied by the mouse cursor.
  465.  
  466.      If the left button is held down while moving the mouse, and the mouse
  467.      cursor reaches a border, the worksheet will start scrolling in the
  468.      direction of mouse movement.  This motion will continue until the
  469.  
  470.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [8] 
  471.      outer limits of the worksheet are reached.  The cell pointer will be
  472.      positioned in the last cell where movement was stopped.
  473.  
  474.      The sensitivity of the mouse while scrolling may cause overshoot of
  475.      the desired window on some fast computers.  If this happens, you can
  476.      move the cell pointer one cell at a time by clicking on the scroll
  477.      bar pointers in the right and bottom borders.
  478.  
  479.      Throughout this manual, when a reference is made to the [ENTER] key,
  480.      the left mouse button will also be implied.  Similarly, when
  481.      reference is made to the [ESC] key, the right mouse button should be
  482.      assumed to perform the same function.
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [9] 
  530.     STARTING THE PROGRAM
  531.     ~~~~~~~~~~~~~~~~~~~~
  532.     The system configuration and certain default parameters can be
  533.     specified when the program is started.  Various configuration options
  534.     can be invoked by a number of command line switches (each switch is
  535.     preceded by a slash [/] character).  Note that most of the same
  536.     defaults can also be changed in the AS-EASY-AS Configuration file.
  537.     See User, Install in Section 10 for further information.
  538.  
  539.     The general form to start the program is:
  540.  
  541.         ASEASY /switch1/switch2/switch3...
  542.                where switch1, switch2,... are explained below
  543.  
  544.  
  545.     COMMAND LINE SWITCHES
  546.     ~~~~~~~~~~~~~~~~~~~~~
  547.     Switches are limited to a maximum of 47 characters on the command line.
  548.     The following command line switch options can appear in any order.
  549.  
  550.  
  551.     ATT - AT&T Monochrome System.
  552.      Set this switch if you are using AS-EASY-AS on an AT&T System to
  553.      produce graphics with a resolution of 640x400.
  554.  
  555.     AUTO=Filename - Autoload Worksheet.
  556.      This switch instructs AS-EASY-AS to automatically load a worksheet
  557.      upon program startup.  Be sure to specify the file's .WKS extension
  558.      and path, if the file is not located in the default directory.
  559.  
  560.      Note: File names containing a hyphen "-" can not be auto-
  561.            loaded. However, the underscore character "_" is
  562.            acceptable. The file name of an auto-loaded file will not
  563.            appear on the status line.
  564.  
  565.     BK=X  - Screen Blanking Time
  566.      This switch sets the screen blanking time.  If your computer is left
  567.      inactive (no key pressed) for X-seconds, the screen will blank out to
  568.      prevent phosphor burnout due to long periods of reverse video (i.e.
  569.      the BORDERS). Pressing any key will re-display the sheet. (We suggest
  570.      using the ESCAPE key).
  571.  
  572.      The default blank out time is set to 5 minutes (i.e., X=300).  If a
  573.      blanking time of 0 is used, screen blanking will be disabled.
  574.  
  575.     CFG=Path\File - Specifies the configuration file to be used.  This
  576.      allows using multiple configuration files for specific applictions,
  577.      or different users on a network.  Ex.  /cfg=d:\DATA\MYCONFIG.CFG
  578.  
  579.     DIR=Path - Sets the Default Directory/Data Path
  580.      The default data drive and subdirectory is the drive and subdirectory
  581.      from which the program was started.  This switch allows you to change
  582.      the default drive/directory.
  583.  
  584.  
  585.  
  586.  
  587.  
  588.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [10] 
  589.     E - Enhanced Graphics Adaptor
  590.      This switch specifies an IBM Enhanced Graphics Adaptor or equivalent
  591.      available for graphics.  The resolution on the EGA screen is 640x350
  592.      pixels with multiple colors.
  593.  
  594.     EV - VGA Monitor/Card (640x480)
  595.      Specifies that your computer is equipped with a VGA monitor and
  596.      adapter card, capable of displaying at a 640x480 pixel resolution.
  597.      If your system is equipped with such a monitor/card combination and
  598.      the /EV switch is not used, the program will most likely start up in
  599.      EGA or CGA mode.
  600.  
  601.     H - Hercules System
  602.      This switch specifies that you are using a Hercules Mono-Graphics
  603.      board or clone.  The resolution of the screen, when plotting
  604.      graphics, is 720x348 pixels and will use the first graphics page at
  605.      $b000.  To force graphics to the second graphics page at $b800 follow
  606.      the H with a 2, i.e., H2.
  607.  
  608.     NE - Don't Use Expanded Memory
  609.      Do not use expanded memory, even if it is found on your computer.
  610.      AS-EASY-AS will automatically use all the expanded memory it detects
  611.      unless this switch is used.
  612.  
  613.     MONO  - Monochrome (B&W)
  614.      Change all colors to a white/black color scheme.  This can be used on
  615.      monitors which do not display all colors visibly, such as LCD
  616.      monitors found on most laptops.
  617.  
  618.     NT - Non-Turbo Keyboard
  619.      Cursor movement using the keyboard cursor keys defaults to a "turbo"
  620.      mode.  Turbo speeds up cursor movement on 286 ATs and above.  It may
  621.      not be compatible with some types of computers, such as the PCjr.
  622.      Therefore, the turbo feature may be disabled by use of the NT switch.
  623.  
  624.     RA - Round Absolute
  625.      By setting this switch, the absolute value of negative numbers is
  626.      used when rounding.  If the RA switch is NOT used @Round(1.6,0)=2 and
  627.      @Round(-1.6,0)=1.  If AS-EASY-AS is started with the RA switch,
  628.      @Round(1.6,0)=2 and @Round(-1.6,0)=-2.
  629.  
  630.  
  631.     V1 - CGA Mode
  632.      Force EGA/VGA cards operation to CGA mode.  This might be necessary
  633.      for some non-standard EGA/VGA monitors and video card combinations.
  634.  
  635.     VM=XXX - Use Virtual Memory
  636.      This command line switch instructs AS-EASY-AS to use a disk drive to
  637.      emulate EMS RAM.  XXX represents the maximum number of 2K packages to
  638.      use as EMS memory.  (i.e. /VM=10 is equivalent to 160K of EMS.)
  639.  
  640.     VP=Drive\Path; - Path for Virtual EMS
  641.      Specifies the drive and subdirectory to by used by AS-EASY-AS when
  642.      the /VM switch is used.  The default is the start-up drive\directory.
  643.      You may specify another drive which has more available space to be
  644.      used for the temporary files.  Note the ";" at the end of the path
  645.      name.
  646.  
  647.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [11] 
  648.     Any combination of valid switches (depending on your system) can be
  649.     used.
  650.  
  651.     As an example, ASEASY/E/NE/DIR=C:\DATA instructs AS-EASY-AS to start
  652.     in EGA mode, not to use expanded memory, and set the default data
  653.     drive and directory to C:\DATA.
  654.  
  655.     By creating individual batch files, you could start AS-EASY-AS on a
  656.     number of different systems, without having to remember all the
  657.     switches required.
  658.  
  659.  
  660.  
  661.     STARTING AS-EASY-AS FROM ANY DIRECTORY
  662.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  663.     AS-EASY-AS can be started from any drive/directory on your hard disk
  664.     simply by typing ASEASY.  To do so, you must make sure that the
  665.     directory where the ASEASY program files are located is in your DOS
  666.     path, and you also need to set a DOS environment variable to point to
  667.     that directory.
  668.  
  669.     The variable is ASEASY and it can be set using the DOS SET command,
  670.     e.g.
  671.  
  672.              SET ASEASY=D:\Subdirectory
  673.                         |
  674.                      Drive and directory where the AS-EASY-AS
  675.                      program files are located.
  676.  
  677.     Consult your DOS manual for more information on the PATH and SET
  678.     statements.
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [12] 
  707.     MENUS
  708.     ~~~~~
  709.     All AS-EASY-AS commands are accessed through menus which are invoked
  710.     by pressing the [/] key.  This key is usually located on the lower
  711.     right side of the keyboard, just above the space bar.  An alternate
  712.     key may be specified, refer to User, Install, Punctuate, Menukey for
  713.     details.
  714.  
  715.     If you use a mouse, command menus are invoked by pressing the right
  716.     mouse button when the program is in the Ready! mode.  The main command
  717.     menu will drop down and provide access to all other menu commands.  If
  718.     the right button was selected in error, tapping the right button again
  719.     will return you to the Ready! mode.
  720.  
  721.     In order for your mouse to be operational, your mouse driver needs to
  722.     be loaded prior to starting AS-EASY-AS (see Section 2 on using the
  723.     mouse).
  724.  
  725.     When the [/] key is pressed, the main menu will appear in the
  726.     top left corner of the screen.  As you will see later, window menus
  727.     provide you with a useful trail through the different levels of menus
  728.     in the program.
  729.  
  730.     The first option in the menu will be indicated by a moveable pointer.
  731.     The command area line, on the top of the screen, will display
  732.     additional information about the option or menu choice.
  733.  
  734.     The pointer can be moved by pressing the cursor arrow keys or by
  735.     moving the mouse pointer, if your mouse is active.  [HOME] will move
  736.     the selection bar to the first menu option, while [END] will move it
  737.     to the last one. Pressing [LEFT], [UP] or [BACKSPACE] will move the
  738.     selection bar up. Pressing [RIGHT], [DOWN] or [SPACE] will move the
  739.     selection bar down.
  740.  
  741.     To select a command or sub menu, use the cursor keys to highlight the
  742.     command you want and press the [ENTER] key.  An alternative way is to
  743.     press the key corresponding to the first letter of the desired option.
  744.     For example, when the main menu is displayed, pressing S gets you in
  745.     the Sheet menu, or pressing R gets you in the Range menu, etc.
  746.     Tapping the left mouse button will select the highlighted command.
  747.     Continue the process until the desired command is reached.  Tapping
  748.     the right button once is the equivalent of hitting [ESC], and will
  749.     return you to the previous menu.
  750.  
  751.     Once a selection is made, a new menu window appears in the same
  752.     location. This window is actually made up of two parts. The top part
  753.     displays the option you selected in the previous menu. The bottom part
  754.     is a menu, with the last option selected highlighted.  You can select
  755.     an option from this menu either by highlighting the choice and
  756.     pressing [ENTER] or by pressing the key corresponding to the first
  757.     letter of the option.
  758.  
  759.     To facilitate repetitive tasks, AS-EASY-AS remembers the last sequence
  760.     of menu commands used.  If the main menu is selected a second time,
  761.     you will notice the command last used is highlighted.  To reuse the
  762.     same command, simply press [ENTER] or click the left mouse button to
  763.     select the command, and continue likewise through the submenus.
  764.  
  765.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [13] 
  766.     The display menu window can be shifted between the left and right
  767.     sides of the screen by pressing the period [.] key.  Press period (.)
  768.     again and it returns to its original position.  Once the menu window
  769.     has been placed either on the left or the right side of the screen, it
  770.     will appear there every time the menu is accessed until it is moved
  771.     again or until the program is exited.
  772.  
  773.     Both the width and the position of the menu window can also be
  774.     adjusted by macro commands (see Section 8, Macros).
  775.  
  776.     When the number of selection items is too large, (such as filename in
  777.     a directory) to be displayed on a single screen as may occur during
  778.     /File Retrieve, only a single page at a time is presented.  Viewing
  779.     successive pages can be achieved by moving the cursor past the bottom
  780.     row or using the [PgUp] and [PgDn] keys.
  781.  
  782.     As you can see, with this menuing technique, at any time you can tell
  783.     exactly what you are doing.  If you don't think that this is
  784.     important, consider the following:
  785.  
  786.      Assume that your current menu is displaying the menu of cell FORMAT
  787.      options.  Unless you have kept track of all your previous keystrokes, it
  788.      is very hard to tell exactly what you are trying to format.  This is
  789.      because the FORMAT menu can be accessed from a number of different
  790.      menus as shown.
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [14] 
  825.     VIEWS/WINDOWS
  826.     ~~~~~~~~~~~~~
  827.     AS-EASY-AS has the ability to open up to six windows or views of the
  828.     worksheet at one time.  Worksheet views can be arranged and resized on
  829.     the screen according to your preference.  When multiple views are
  830.     created, only one window can be worked on at a time.  This is called
  831.     the active window and is identified by a blinking cursor.  The [F7]
  832.     key is used to toggle between worksheet views.  The cell pointer
  833.     identifies which view is active.
  834.  
  835.     The windows can be manipulated by using a mouse, or through the View
  836.     menu command.
  837.  
  838.     With a mouse, to resize the window, position the mouse pointer on the
  839.     "┘" character in lower right corner of the window.  Depress the left
  840.     button and drag the mouse to the desired size.  Dragging the "■"
  841.     located in the upper right corner of the window will move the window.
  842.     Positioning the mouse pointer on any portion of an inactive window and
  843.     clicking the left button makes that window active.
  844.  
  845.     The following View menu subcommands allow manipulation of the windows.
  846.  
  847.     OPEN - creates a new view based on the active window.  If this process
  848.     is continued, multiple views of the worksheet will be created.  Up to
  849.     six worksheet views can be created at one time.  Worksheets will
  850.     overlap each other (layer) when opened.  If an attempt is made to open
  851.     a seventh window, an error message will appear warning that the
  852.     maximum number of windows has been exceeded.
  853.  
  854.     CLOSE - will terminate the current worksheet view.  This command can
  855.     be repeated until all views are removed.  Closing a middle view will
  856.     result in the windows being renumbered accordingly.  For example, if
  857.     six window views are created (1,2,3,4,5,6) and window number three is
  858.     closed, windows 5 and 6 will automatically renumber to read
  859.     (1,2,3,4,5).
  860.  
  861.     LAYER - will arrange all the open windows on the screen at once.  [F7]
  862.     is used to toggle between worksheets and is used to select the active
  863.     window.  Each time a new window is opened, it is layered below and to
  864.     the right of the previous window.
  865.  
  866.     ZOOM - will expand the active window to fill the entire screen.  This
  867.     command will allow you to take a closer look at the worksheet.
  868.  
  869.     SIZE - changes the width and/or height of the window.  The smallest
  870.     view size is 22 character columns by 4 character rows. The number of
  871.     columns and rows is dependant on the type of graphics text selected.
  872.     The [up], [down], [left], [right], [home], arrow keys can be used to
  873.     reduce and enlarge the worksheet view.
  874.  
  875.     MOVE - repositions the window on the screen.  To move the worksheet,
  876.     the size of the window must first be reduced to less than full-size.
  877.     Use the cursor keys to move the active window.
  878.  
  879.  
  880.  
  881.  
  882.  
  883.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [15] 
  884.  
  885.     MOVING AROUND THE SHEET
  886.     ~~~~~~~~~~~~~~~~~~~~~~~
  887.     For keyboards with a combined cursor/number key pad, first make sure
  888.     the NUM status indicator is NOT displayed on the status line.  This
  889.     means that the cursor key pad is active.  Next, take a close look at
  890.     the cursor key pad (usually located on the right side of your
  891.     keyboard).  Each key performs the following action:
  892.  
  893.  
  894.      [HOME]          Move the cursor to cell position A1 or the
  895.                      border boundary
  896.      [UP]            Move the cursor up one row
  897.      [PGUP]          Move the cursor up one screen page
  898.      [DOWN]          Move the cursor down one row
  899.      [PGDN]          Move the cursor down one screen page
  900.      [LEFT]          Move the cursor left one column
  901.      [RIGHT]         Move the cursor right one column
  902.      [END]           This key acts in combination with the next
  903.                      cursor key pressed.  It causes the spreadsheet to
  904.                      scan in the indicated direction until a change of
  905.                      state occurs.  For example, a column of numbers
  906.                      with a blank cell in the middle will result in the
  907.                      cursor stopping at the blank cell.  Subsequent
  908.                      [END] [DOWN] will jump to the bottom of the
  909.                      column.
  910.      [END][UP]       Move to far top of range
  911.      [END][DOWN]     Move to far bottom of range
  912.      [END][LEFT]     Move to far left of range
  913.      [END][RIGHT]    Move to far right of range
  914.      [END][HOME]     Move to lower right corner of sheet
  915.  
  916.     Other movement keys:
  917.  
  918.       [TAB]            Move one page right
  919.       [CTRL] [RIGHT]
  920.  
  921.       [SHIFT][TAB]     Move one page left
  922.       [CTRL] [LEFT]
  923.  
  924.       [F5]             Go to specified cell
  925.  
  926.       [F6]             When the /Sheet Window option has been
  927.                        selected, pressing F6 moves the cursor between
  928.                        the two windows. With only one window active,
  929.                        pressing F6 toggles between the current and the
  930.                        last position of the cursor.
  931.  
  932.       [F7]             The F7 function key is used to toggle between
  933.                        worksheet views when multiple windows are
  934.                        created.
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [16] 
  943.  
  944.     SMART CURSOR
  945.     ~~~~~~~~~~~~
  946.     Smart Cursor will automatically move the cell pointer one cell in the
  947.     direction of the last cursor movement after the [ENTER] key has been
  948.     pressed.  Smart Cursor is toggled on/off by pressing the [SCROLL LOCK]
  949.     key.  "SCR" displayed in the status line indicates Smart Cursor is
  950.     active.
  951.  
  952.     When active, if a number is typed into a cell, followed by [ENTER] and
  953.     a cursor key, Smart Cursor remembers the direction of movement.
  954.     Subsequent input of data, followed by [ENTER], will place the data in
  955.     the cell, and move the cursor one cell in the established direction of
  956.     movement.  If a cursur key is again pressed, that direction becomes
  957.     the new direction of movement.
  958.  
  959.     For example, when you type the number 1 in cell A1 and press [ENTER],
  960.     the cursor remains in cell A1.  If you move the cursor to cell A2 and
  961.     type the number 2, the cursor will automatically move to cell A3 after
  962.     [ENTER] has been pressed.
  963.  
  964.  
  965.  
  966.     FUNCTION KEYS
  967.     ~~~~~~~~~~~~~
  968.     F1 - Help Function Key (when ready mode is active)
  969.      To choose among the help topics, press the up/down cursor keys to
  970.      move the highlighted cursor to the one desired.  To move around
  971.      within the help topic list, press the [HOME] key to go to the top of
  972.      the list; the [END] key to go to the bottom of the list; the [PAGE
  973.      UP] key to go to the top the list that is visible on the screen;
  974.      press the [PAGE DOWN] key to go to the bottom of the list that is
  975.      visible on the screen.  To search more quickly for a topic, press the
  976.      first letter of the desired topic.
  977.  
  978.      Press the [ENTER] key to select the topic and the cursor will move to
  979.      the informational help window on the right side of the screen.
  980.  
  981.      Once a help topic has been chosen and entered, use the up/down cursor
  982.      keys to scroll through the file.  The highlighted bottom boundary of
  983.      a file disappears when the end of the file has been reached.
  984.  
  985.      To exit one help topic and enter another, hit the [ENTER] or the
  986.      [LEFT] cursor key, scroll up or down to the desired topic, and hit
  987.      the enter key.  The first letter quick-search method may also be
  988.      used.
  989.  
  990.      To exit the help menu altogether, hit the [ESCAPE] key.
  991.  
  992.     F1 - Help When Entering a Macro
  993.      If you are typing a macro and the last key typed was the "{" key,
  994.      pressing [F1] will open a pick window in the middle of your screen,
  995.      displaying all the macro commands available to you.  Move the cursor
  996.      using the arrow keys, select the macro command you want and press
  997.      [ENTER].  The macro command is inserted, at the cursor position, and
  998.      you are ready to continue typing.
  999.  
  1000.  
  1001.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [17] 
  1002.     F1 - Help When Entering an Equation
  1003.      If you have just entered a valid operator (+, -, *, or /), pressing
  1004.      F1 will display all named ranges defined in the spreadsheet. Select
  1005.      the one you want, using the cursor, press [ENTER] and the named range
  1006.      is inserted in your equation.
  1007.  
  1008.     F1 - HELP When Entering a Function
  1009.      If you have just pressed the "@" key, pressing F1 will open a
  1010.      selection window in the middle of your screen, and will display all
  1011.      the @-Functions available to you.  When the function list appears,
  1012.      move the cursor using the arrow keys, pick the function you want and
  1013.      press [ENTER]. The function is inserted and you are ready to continue
  1014.      typing.  Pressing the [ESC] key, when the function list appears, will
  1015.      cancel the operation but still leave you in the edit mode.
  1016.  
  1017.     F1 - HELP When Entering a Printer Setup Code
  1018.      If you are in the PrintTo Printer Options Setup submenu and are
  1019.      trying to remember a printer setup code, all you need to do is press
  1020.      [\] followed by F1. A selection window displays the setup codes that
  1021.      you have placed in your printer set-up file (see section on Printer
  1022.      Options).  Move the cursor with the arrow keys, select the setup code
  1023.      that you want, and press [ENTER].   AS-EASY-AS will insert the
  1024.      selected printer setup code and you can continue with your next
  1025.      operation.
  1026.  
  1027.      This is a great feature for those who have to use complicated lengthy
  1028.      laser printer setup strings.
  1029.  
  1030.      The F1 option is also available when embedding setup codes directly
  1031.      in a print range (see section on Printer Options).
  1032.  
  1033.  
  1034.      NOTES:  1.  You can still manually enter the setup codes if you prefer.
  1035.  
  1036.              2.  The printer setup file has the name ASEASY.PRT and must
  1037.                  be in the default directory.
  1038.  
  1039.     F2 - Edit Function Key
  1040.      Pressing the F2 function key places a copy of the contents of the
  1041.      current cell on the second line of the command panel area, and
  1042.      invokes the edit mode. For more information about the edit mode
  1043.      options, refer to Section 3.2.
  1044.  
  1045.     F3 - Macro Function Key
  1046.      The F3 function key allows execution of a macro by name or by cell
  1047.      reference. When F3 is pressed, a prompt appears requesting the name
  1048.      of the macro that you want to execute.  The default address is the
  1049.      cell reference specified the last time F3 was invoked during the
  1050.      current session.  You can either type the name of the macro you want
  1051.      to execute and press [ENTER] or press [ESC].
  1052.  
  1053.      Pressing [ESC] in response to the prompt will display a pick list of range
  1054.      names to choose from.  Move the cursor to the desired macro name and
  1055.      press [ENTER].
  1056.  
  1057.      NOTE:  This is the equivalent to the {JUMP NAME} macro command.
  1058.  
  1059.  
  1060.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [18] 
  1061.     F4 - Absolute Address Function Key
  1062.      Pressing F4 when in the middle of entering a formula, makes the
  1063.      address of the current cell absolute (both row and column).  Pressing
  1064.      F4 once more makes only the column of the current cell absolute and
  1065.      pressing it for the third time makes the reference relative.
  1066.  
  1067.      NOTE: This function key is only active when entering an equation
  1068.            in the pointing mode.  It is not active when editing a cell.
  1069.  
  1070.     F5 - GoTo Function Key
  1071.      The GOTO function key allows you to position the cursor on a cell
  1072.      indicated by name or by reference.  When the prompt for the
  1073.      destination appears, pressing [ESC] will present a window of range
  1074.      names from which to choose. The default address is the address
  1075.      specified last time F5 was invoked during the current session.
  1076.  
  1077.     F6 - Window/Location Function Key
  1078.      The F6 function key toggles the cell cursor between the current
  1079.      location and the last location the cell cursor occupied.  When the
  1080.      Sheet, Windows command has been invoked, pressing the F6 key will
  1081.      toggle the cursor between the two windows.  When the Sheet, Borders
  1082.      command has been invoked, pressing the F6 key will toggle the cursor
  1083.      into and out of the border area (only if a border was assigned to one
  1084.      window).
  1085.  
  1086.     F7 - View Key
  1087.      The F7 function key is used to toggle between worksheet views when
  1088.      multiple windows are created.  Up to six window views can be opened
  1089.      but only one window can be worked on at a time.  This is called the
  1090.      active window and is identified by a visable cell pointer.
  1091.  
  1092.     F9 - Calculate Function Key
  1093.      When the ready mode is active, pressing F9 results in all cells being
  1094.      recalculated.
  1095.  
  1096.      Another feature of the F9 key is that it performs the calculation of
  1097.      any equation, at any point in an editing AS-EASY-AS operation.  When
  1098.      editing a formula, pressing F9 replaces the entire formula with its
  1099.      evaluated result.
  1100.  
  1101.      Example:  Cell A1 contains the value 1, and
  1102.                Cell A2 contains the value 2
  1103.  
  1104.      Place the cursor in cell B1 and press the following keys:
  1105.  
  1106.         /scsA1+A2 [F9] [ENTER]
  1107.                        |
  1108.                 Function Key
  1109.  
  1110.      This will set the width of column B to 3, i.e., the value of cell A1
  1111.      plus the value of cell A2.
  1112.  
  1113.     F10 - Graph Function Key
  1114.      Pressing F10 displays the currently defined graph.  If no graph has
  1115.      been defined, a beep will sound and an error message will be
  1116.      displayed.
  1117.  
  1118.  
  1119.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [19] 
  1120.     3. BASICS
  1121.     ~~~~~~~~~
  1122.     This section provides information necessary to perform basic
  1123.     functions, such as entering text, values, and formulas, and editing
  1124.     data once it has been entered.  It also describes basic skills and
  1125.     concepts, such as copying and moving cells, inserting and deleting
  1126.     rows and columns, creating and using range names, and file management.
  1127.  
  1128.  
  1129.     ENTERING LABELS
  1130.     ~~~~~~~~~~~~~~~
  1131.     A label is any sequence of characters which is not preceded with a
  1132.     digit or mathematical operator.  Digits may be entered as labels if
  1133.     they are preceded with an apostrophe ['], a caret  [^], a quote  ["],
  1134.     a backslash [\], or a pipeline [|] character.  These label prefix
  1135.     characters are special formatting characters which perform the
  1136.     following:
  1137.  
  1138.      [']     Left justifies the label within the column
  1139.      [^]     Centers the label within the column.  If the label is
  1140.              wider than the column, the result is left justified.
  1141.      ["]     Right justifies the label within the column.  If the label
  1142.              is wider than the column, the result is left justified.
  1143.      [\]     Repeats the character which follows, the width of the column.
  1144.      [|]     Sends the characters that follow to the printer as a setup
  1145.              string. (The "|" character is not displayed on screen).
  1146.      [«]     (Alt-174 on keypad) Pad string with periods on the left side.
  1147.      [»]     (Alt-175 on keypad) Pad string with periods on the right.
  1148.  
  1149.     The default prefix character is an apostrophe ['] which will
  1150.     automatically be inserted as the first character.  Prefix characters
  1151.     are interpreted as text if they appear other than in the first
  1152.     position of the label.
  1153.  
  1154.     NOTE: Digits that have been entered with a label prefix character are
  1155.     labels.  As a label, the digits will be evaluated as having a value of
  1156.     zero.  Therefore, it is not possible to left or center justify numbers
  1157.     and be able to use them in equations.
  1158.  
  1159.  
  1160.     ENTERING VALUES
  1161.     ~~~~~~~~~~~~~~~
  1162.     A value is any sequence of digits.  AS-EASY-AS supports 11 significant
  1163.     digits.  Large numbers are entered by using exponential notation.
  1164.  
  1165.     For example, the number 2.3x1015 would be entered as 2.3E15 [ENTER].
  1166.  
  1167.     All entries must be completed by pressing the [ENTER] key or one of
  1168.     the direction keys.  If one of these keys has not been pressed, the
  1169.     [BackSpace] key may be used to delete the previously entered digit.
  1170.  
  1171.     The limiting range of numbers recognized by the program is 1.0E-37 <
  1172.     |X| < 1.0E+37
  1173.  
  1174.     If a cell contains only asterisks, "*********", it's an indication
  1175.     that the width of the column is insufficient to hold all the
  1176.     characters required to display the number.  To make the value visible,
  1177.  
  1178.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [20] 
  1179.     either expand the column width or change the format of the
  1180.     cell.
  1181.  
  1182.  
  1183.     ENTERING FORMULAS
  1184.     ~~~~~~~~~~~~~~~~~
  1185.     The power of a spreadsheet stems from its ability to interrelate the
  1186.     contents of its cells.  These relationships are set through the use of
  1187.     formulas that are entered directly into the cells. Once entered, the
  1188.     formulas may be saved with the spreadsheet, copied, edited, or moved
  1189.     etc.  Relationships between cells are formed using algebraic,
  1190.     statistical or logical expressions. Once a formula is typed in and
  1191.     [ENTER] is pressed, it is evaluated and the result is placed in the
  1192.     cell.  The following operators are available for use in cell formulas:
  1193.  
  1194.         [-]     -  negation
  1195.         [+]     -  addition
  1196.         [-]     -  subtraction
  1197.         [*]     -  multiplication
  1198.         [/]     -  division
  1199.         [!]     -  factorial
  1200.         [%]     -  percent
  1201.         [^]     -  exponentiation
  1202.         [>]     -  greater than
  1203.         [<]     -  less than
  1204.         [=]     -  equal to
  1205.         [<=]    -  less than or equal
  1206.         [>=]    -  greater than or equal
  1207.         [<>]    -  not equal to
  1208.         [()]    -  parentheses
  1209.  
  1210.     A formula must be preceded by one of the following characters:
  1211.                      -  +  (  @   or a digit.
  1212.  
  1213.     The following examples assume that cell A1 contains the value 4.
  1214.  
  1215.         Type           Result   Comment
  1216.         ~~~~~~~~~~~    ~~~~~~   ~~~~~~~~~~
  1217.         1.1+2*3+5^2    32.1     --
  1218.         +A1*2+5.5      13.5     --
  1219.         @SQRT(A1)+5     7.0     --
  1220.         (2*A1+3)*3     33.0     --
  1221.         -5.1+2         -3.1     --
  1222.         2>3               0     Result is False
  1223.         3>2               1     Result is True
  1224.         5<>4              1     Result is True
  1225.         6=5               0     Result is False
  1226.  
  1227.     Parenthesis are used to group calculations and force a specific order
  1228.     of evaluation.  AS-EASY-AS will first evaluate the expression in
  1229.     parentheses, then continue in order of operator precedence.  As an
  1230.     example:
  1231.  
  1232.         (2+3)*6 evaluates to 30, while 2+(3*6) evaluates to 20.
  1233.  
  1234.     Quotes must be used to indicate string arguments.  For example:
  1235.         +"Hello"&" Tom!" will display Hello Tom in a cell.
  1236.  
  1237.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [21] 
  1238.     ENTERING GRAPHICS CHARACTERS
  1239.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1240.     AS-EASY-AS permits entry of high bit ASCII characters (sometimes
  1241.     referred to as graphics or box characters).  To create one of these
  1242.     characters, hold the [ALT] key down and enter the decimal code of the
  1243.     character you want using the numeric pad (on the right side of your
  1244.     keyboard).  When you let go of the [ALT] key, the specified character
  1245.     will appear.  For example, if you type 195 (while holding down the
  1246.     [Alt] key) the character ├ will appear on your screen.  See Appendix E
  1247.     for a listing of ASCII characters.
  1248.  
  1249.     NOTE:   Some graphics characters can be printed only if they are
  1250.             supported by your printer.
  1251.  
  1252.  
  1253.  
  1254.     EDITING A CELL
  1255.     ~~~~~~~~~~~~~~
  1256.     Changes to the contents of a cell may be made by retyping the contents
  1257.     and pressing [ENTER] or by invoking the Edit Mode, using the Edit
  1258.     Function Key [F2].
  1259.  
  1260.     Pressing [F2] causes the contents of the current cell to be placed on
  1261.     line 1 of the command panel.  The mode indicator is changed to EDIT.
  1262.     The character cursor is positioned at the end of the line.  Make
  1263.     changes by moving the character cursor to the desired position and
  1264.     start typing.
  1265.  
  1266.     When in the edit mode with insert active, text under and to right of
  1267.     the cursor will be shifted to the right as characters are typed.
  1268.     Insert can be toggled on/off by pressing the insert [INS] key.  The
  1269.     opposite of insert mode is overwrite mode which is indicated by an
  1270.     increase in cursor size and the display of the OVR status indicator
  1271.     (text will be overwritten by new typing).
  1272.  
  1273.     The following keys may be used to edit:
  1274.  
  1275.         [LEFT]          Move cursor one position to the left
  1276.         [RIGHT]         Move cursor one position to the right
  1277.         [HOME]          Move cursor to the first character position
  1278.         [END]           Move cursor to the last character position
  1279.         [INS]           Toggle between overwrite and insert mode
  1280.         [DEL]           Delete the character underneath the cursor
  1281.         [BACKSPACE]     Delete the character left of the cursor
  1282.         [TAB]           Move 8 positions to the right
  1283.         [SHIFT][TAB]    Move 8 positions to the left
  1284.         [CTRL][RIGHT]   Move to the beginning of the next word
  1285.         [CTRL][LEFT]    Move to the beginning of the previous word
  1286.         [ESC]           Cancel all editing and leave original cell contents
  1287.  
  1288.     After all changes have been made you must press the [ENTER] key to
  1289.     insert the changes into the current cell in the worksheet.
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [22] 
  1297.     METHODS FOR ENTERING FORMULAS
  1298.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1299.     There are two ways to enter a formula into an AS-EASY-AS cell.  One is
  1300.     to type the whole formula and the second is to point to the referred
  1301.     cells.
  1302.  
  1303.     For example let's say that you want to enter the following formula in
  1304.     cell B6.
  1305.  
  1306.         @SUM(A5..A12)+A1/(C6*C8)
  1307.  
  1308.     This could be accomplished in two ways as shown below (assuming that
  1309.     the cursor is already in cell B6).
  1310.  
  1311.     POINTING METHOD:
  1312.     ~~~~~~~~~~~~~~~~
  1313.     TYPE   PRESS               SHOWN ON CONTROL PANEL
  1314.     ~~~~   ~~~~~               ~~~~~~~~~~~~~~~~~~~~~~
  1315.     @SUM(                      @SUM(
  1316.            [LEFT]              @SUM(A6
  1317.            [UP]                @SUM(A5
  1318.            (period).           @SUM(A5..A5
  1319.            [DOWN](7 times)     @SUM(A5..A12
  1320.            )+                  @SUM(A5..A12)+
  1321.            [HOME]              @SUM(A5..A12)+A1
  1322.            /(                  @SUM(A5..A12)+A1/(C6
  1323.            [RIGHT]             @SUM(A5..A12)+A1/(C6
  1324.            *                   @SUM(A5..A12)+A1/(C6*
  1325.            [RIGHT]             @SUM(A5..A12)+A1/(C6*C6
  1326.            [DOWN]              @SUM(A5..A12)+A1/(C6*C7
  1327.            [DOWN]              @SUM(A5..A12)+A1/(C6*C8
  1328.            )                   @SUM(A5..A12)+A1/(C6*C8)
  1329.            [ENTER]             @SUM(A5..A12)+A1/(C6*C8)
  1330.  
  1331.     And the calculated value is displayed in cell B6.
  1332.  
  1333.  
  1334.     TYPING METHOD:
  1335.     ~~~~~~~~~~~~~~
  1336.     With the cursor positioned on cell B6, type:
  1337.  
  1338.         @SUM(A5..A12)+A1/(C6*C8)
  1339.  
  1340.     and press [ENTER].  The calculated value will appear in cell B6, and
  1341.     the above equation will show on the control panel.
  1342.  
  1343.     Cell references can be either absolute or relative.  An absolute cell
  1344.     has the row or column to be fixed preceded by a '$', i.e. $A1 fixes
  1345.     the column portion of the cell reference.  A block copy of a formula
  1346.     with this cell reference will not alter the 'A' portion of the cell.
  1347.     $A$1 fixes both the row and column portion of the cell.  Without the
  1348.     '$' all copies of the cell formula will result in a translation of the
  1349.     cell reference which maintains the relative reference. Cell references
  1350.     must be preceded by either a '+' or '-' sign or a parenthesis.
  1351.  
  1352.     See the section on copying and moving for more information on relative
  1353.     and absolute references.
  1354.  
  1355.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [23] 
  1356.     WHAT IS A RANGE
  1357.     ~~~~~~~~~~~~~~~
  1358.     A range is defined as any rectangular group of cells in the
  1359.     spreadsheet.  A range can be as narrow as a single row in depth or as
  1360.     deep as all the rows in the spreadsheet.  Similarly a range can be as
  1361.     narrow as a single column in width or as wide as all the columns in
  1362.     the spreadsheet (256).
  1363.  
  1364.     A range is described by specifying the upper left cell and lower right
  1365.     cell of the range.  The cells must be separated by two periods '..' .
  1366.     An example of this is A1..D5.  This includes all cells in columns A,
  1367.     B, C and D and rows  1, 2, 3, 4 and 5.
  1368.  
  1369.     The entire group of cells looks like this:
  1370.  
  1371.        A1     B1     C1     D1
  1372.        A2     B2     C2     D2
  1373.        A3     B3     C3     D3
  1374.        A4     B4     C4     D4
  1375.        A5     B5     C5     D5
  1376.  
  1377.  
  1378.     DEFINING A RANGE
  1379.     ~~~~~~~~~~~~~~~~
  1380.     Ranges can be defined by using one of two possible methods:  pointing
  1381.     to the cell or range of cells, or actually typing in the range (upper
  1382.     left cell followed by two periods and then the lower right cell) or
  1383.     range name.
  1384.  
  1385.  
  1386.  
  1387.     POINTING WITH THE ARROW KEYS
  1388.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1389.     Pointing to a cell simply involves moving the cursor.  It is best to
  1390.     use this method in response to COPY or MOVE commands.  When asked for
  1391.     a range, move the pointer.  Notice that the pointer expands on the
  1392.     screen.  In the middle of the leading edge of the pointer you will see
  1393.     a small blinking cursor. This indicates the corner of the range which
  1394.     you can expand or contract.  To switch to the next corner press the
  1395.     period [.].  If you press the period 4 times, you will return to your
  1396.     starting position. When the range has been completely highlighted,
  1397.     press the [ENTER] key. This fixes the range and allows any action to
  1398.     continue. For example, if the range was entered in response to a COPY
  1399.     command, the copy operation be initiated.
  1400.  
  1401.  
  1402.     POINTING WITH THE MOUSE
  1403.     ~~~~~~~~~~~~~~~~~~~~~~~
  1404.     The mouse may be used when building ranges in AS-EASY-AS.  The process
  1405.     of pointing with the mouse is similar to that pointing with the arrow
  1406.     keys. (Note that in order to use the mouse, your mouse driver needs to
  1407.     be loaded prior to starting AS-EASY-AS).
  1408.  
  1409.     When prompted for a cell range, position the mouse pointer at one
  1410.     corner of the range and press the left mouse button.  Keep it
  1411.     depressed as you move the mouse until the desired range is
  1412.     highlighted.  Release the button to signify the end of the range and
  1413.  
  1414.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [24] 
  1415.     click the left mouse button again to confirm the selection (similar to
  1416.     pressing the [ENTER] key at the end of the range definition).  To
  1417.     change the range a second time, hold the mouse button down and repeat
  1418.     the previous step.
  1419.  
  1420.     If you wish to cancel a range or stop the process, tapping the right
  1421.     mouse button will back you through the command.
  1422.  
  1423.     When using the right mouse in conjunction with AS-EASY-AS functions,
  1424.     such as @SUM, the function name and left parenthesis must be typed
  1425.     first,e.g., "@SUM(".  To build the range, position the mouse cursor at
  1426.     the top left cell of the range, depress the left mouse button and
  1427.     build the range. When the range is completed, type the remainder of
  1428.     the function, in our example, this would be the right parenthesis")",
  1429.     and hit [ENTER].  Again, you can proceed back through the range
  1430.     building process by pressing the right mouse button.
  1431.  
  1432.     TYPING
  1433.     ~~~~~~
  1434.     Typing a range may be done by specifying diagonally opposite cell
  1435.     corners of the range.  Each cell reference is separated by one or two
  1436.     periods [.].
  1437.  
  1438.     Example: A1..D5 defines the same range as D1..A5.  When the entry is
  1439.              complete press the [ENTER].
  1440.  
  1441.     NAMING A RANGE
  1442.     ~~~~~~~~~~~~~~
  1443.     A powerful AS-EASY-AS feature is the ability to refer to a range of
  1444.     cells using a name assigned to that range.  Such range names may be
  1445.     used anywhere a cell reference is expected by AS-EASY-AS.  Since a
  1446.     range can also consist of a single cell, this naming ability can be
  1447.     used to create applications and formulas that are easy to understand.
  1448.  
  1449.     For example, let us say that cell A1 contained total income for the
  1450.     month and cell A5 contained total expenses.  If cell A10 contained a
  1451.     formula to calculate the monthly balance, i.e. +A1-A5, then, when you
  1452.     placed the cursor on cell A10, the input line would display  A10:
  1453.     +A1-A5.  If, on the other hand, you had named A1 as INCOME and A5 as
  1454.     EXPENSES, when on A10, the input line would display A10:  +INCOME-
  1455.     EXPENSES, which is much more informative.
  1456.  
  1457.     When entering the formula in A10, with the cells named as above, you
  1458.     could use either the named range or the actual reference.  The
  1459.     keystroke sequences below would yield identical results (assuming the
  1460.     cursor is currently at A10):
  1461.  
  1462.             +A1-A5 [ENTER], or
  1463.             +INCOME-EXPENSES  [ENTER]
  1464.  
  1465.     Ranges are assigned names using the /Range, Name, Create command
  1466.     sequence.
  1467.  
  1468.     Up to 250 named ranges may be defined in a single worksheet.  Each
  1469.     range name can be up to 11 characters long.
  1470.  
  1471.  
  1472.  
  1473.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [25] 
  1474.     SETTING FORMATS
  1475.     ~~~~~~~~~~~~~~~
  1476.     Format refers to the appearance of a cell.  There may be a big
  1477.     difference between the way the contents of a cell is displayed and the
  1478.     way the value of that cell is stored internally.  It helps to keep
  1479.     that in mind at all times.
  1480.  
  1481.  
  1482.     WHY DO YOU NEED FORMATS?
  1483.     ~~~~~~~~~~~~~~~~~~~~~~~~
  1484.     Imagine that a cell contains the result of a calculation where you are
  1485.     trying to figure out the monthly payments on a loan.  Let's say that
  1486.     the calculated payment was 657.17625412 per month.
  1487.  
  1488.     Do you really want to see 8 digits after the decimal point?  Most
  1489.     likely not, and that's where formats come in.
  1490.  
  1491.     A better way to format the payment amount would be:
  1492.  
  1493.          657.18   (rounded to two decimals, cents)
  1494.  
  1495.     or better yet,
  1496.  
  1497.         $657.18
  1498.  
  1499.     NOTE:  Even though the value is displayed as 657.18, the value stored
  1500.            in the cell and used in any calculations involving that cell is
  1501.            657.17625412.
  1502.  
  1503.     Applying a format to a single cell or to a whole range of cells may be
  1504.     done with the /Range, Format command.  Setting the default format for
  1505.     the entire worksheet is done using the /Sheet, General, Format
  1506.     command.
  1507.  
  1508.     Details about the types of formats available in AS-EASY-AS can be
  1509.     found in the command summary section at the end of this manual.
  1510.  
  1511.  
  1512.  
  1513.     RELATIVE VERSUS ABSOLUTE ADDRESSES
  1514.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1515.     AS-EASY-AS does all the work required to keep track of the cells you
  1516.     refer to in formulas:
  1517.  
  1518.         If you move the cells referenced in a formula to another place in
  1519.         the worksheet, AS-EASY-AS automatically adjusts the references in
  1520.         the formula.
  1521.  
  1522.         If you move a formula from one cell to another, cell references in
  1523.         the formula remain unchanged.
  1524.  
  1525.         If you insert a column or row within a specified block, any
  1526.         formula that references the block is automatically adjusted to
  1527.         include it.
  1528.  
  1529.         If you delete a row or column within a block, any formula that
  1530.         references the block is automatically adjusted to exclude it.  An
  1531.  
  1532.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [26] 
  1533.         important exception is if you delete a row or column that contains
  1534.         one of the corner cells included in the range reference, an ERR is
  1535.         entered in the formula cell.  If this occurs, you must reenter the
  1536.         formula with the correct range.
  1537.  
  1538.         If you copy a block of cells that include a formula but not the
  1539.         cells referenced in the formula, the formula is updated to
  1540.         reference new cells which have the same position in relation to
  1541.         the formula's cell.  (Cells viewed this way are called relative
  1542.         cells).
  1543.  
  1544.         If you want to copy a formula and maintain the original cell
  1545.         references, you must specify those references as absolute before
  1546.         copying the formula. This is done by inserting the dollar sign
  1547.         before the cell coordinates.
  1548.  
  1549.             $A$2 -  Makes the entire address absolute
  1550.             $A2  -  Makes the column absolute
  1551.             A$2  -  Makes the row absolute
  1552.  
  1553.         Named ranges operate just like all references and will translate
  1554.         when copied or moved.  To make a named range absolute, you must
  1555.         preface the range name with a dollar sign.
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [27] 
  1592.     COPY VALUES
  1593.     ~~~~~~~~~~~
  1594.     Using the copy command on a value duplicates the value in the "FROM"
  1595.     cell into the "TO" cell.
  1596.  
  1597.     For example, to copy the value from cell B5 to cell C6, simply enter
  1598.     the following sequence of commands (assuming the pointer is already on
  1599.     cell B5):
  1600.  
  1601.         /c [ENTER] [RIGHT] [DOWN] [ENTER]     (Pointing Method)
  1602.                           or
  1603.         /c B5 [ENTER] C6 [ENTER]              (Typing Method)
  1604.  
  1605.  
  1606.  
  1607.     COPY FORMULAS
  1608.     ~~~~~~~~~~~~~
  1609.     Let's take an example of three cells containing the following:
  1610.  
  1611.             cell    B1      contains    +A1+A2
  1612.              ''     B2         ''       +A1+$A2
  1613.              ''     B3         ''       +A1+$A$2
  1614.  
  1615.     The value result in cells B1, B2 and B3 should be identical.
  1616.  
  1617.     Now copy the cells B1, B2 and B3 to C2, C3 and C4 respectively, and
  1618.     let's see what the new cells contain.
  1619.  
  1620.         cell C2:        +B2+B3
  1621.  
  1622.     Copied from an original formula, in B1, that said:  "Add the contents
  1623.     of the cell one column to the left (A1) to the contents of the cell
  1624.     one column to the left and one row down (A2)."
  1625.  
  1626.         cell C3:        +B2+$A3
  1627.  
  1628.     Copied from an original formula, in B2, that said:  "Add the contents
  1629.     of the cell one column to the left (A1) to the contents of the cell in
  1630.     absolute column A ($A) and one row down."
  1631.  
  1632.         cell C4:        +B2+$A$2
  1633.  
  1634.     Copied from an original formula, in B3, that said:  "Add the contents
  1635.     of the cell one column to the left (A1) to the contents of the cell in
  1636.     absolute column A ($A) and in row 2 ($2)."
  1637.  
  1638.  
  1639.     MOVE VALUES
  1640.     ~~~~~~~~~~~
  1641.     Moving values is a simple operation that relocates the value from a cell into
  1642.     another specified cell.
  1643.  
  1644.     For example, to move the value from cell B5 to cell C6, simply enter the
  1645.     following sequence of commands (assuming the pointer is already in cell B5):
  1646.  
  1647.  
  1648.  
  1649.  
  1650.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [28] 
  1651.         /m [ENTER] [RIGHT] [DOWN] [ENTER]    (Pointing Method)
  1652.                      or
  1653.         /m B5 [ENTER] C6 [ENTER]             (Typing Method)
  1654.  
  1655.  
  1656.  
  1657.     MOVE FORMULAS
  1658.     ~~~~~~~~~~~~~
  1659.     The rules that apply to copying formulas also apply to moving
  1660.     formulas. Let's consider the same example of the three cells
  1661.     containing the following:
  1662.  
  1663.         cell    B1      contains    +A1+B4
  1664.           ''    B2          ''      +A1+$B4
  1665.           ''    B3          ''      +A1+$B$4
  1666.           ''    B4          ''      5
  1667.  
  1668.     The values displayed in cells B1, B2, B3 and B4 should be identical.
  1669.     Now move the cells B1, B2, B3 and B4 into C1, C2, C3 and C4
  1670.     respectively.  Let's see what the new cells contain.
  1671.  
  1672.         cell C1:        +A1+C4
  1673.  
  1674.     Notice the translation of B4 to C5.  This occurred because B4 was
  1675.     within the moved block.  The reference to A1 remains unchanged because
  1676.     it was outside the block.
  1677.  
  1678.         cell C2:        +A1+$C4
  1679.  
  1680.     Absolute symbol does NOT keep column reference from changing for the
  1681.     move operation because the reference was inside the moved block.
  1682.  
  1683.         cell C3:        +A1+$C$4
  1684.  
  1685.     Moved from original location but the formula changes the same as in
  1686.     cell C2.
  1687.  
  1688.     As you can see, NO translation occurs for cell references OUTSIDE the
  1689.     block being moved.  References to cells inside the block ARE
  1690.     translated during a move to reflect the new position.
  1691.  
  1692.  
  1693.     RECALCULATION MODES
  1694.     ~~~~~~~~~~~~~~~~~~~
  1695.     Recalculation refers to the manner in which all formulas within a
  1696.     spreadsheet are calculated.  As formula references get complex, the
  1697.     number of required calculations increases.  If every cell within the
  1698.     spreadsheet were calculated each time a cell was updated, it could
  1699.     take a while just to make a minor change.
  1700.  
  1701.     An alternate method is to calculate only those cells which are
  1702.     dependent on the updated cell.  Each dependent cell may have multiple
  1703.     dependent cells which must also be calculated, and so on until a root
  1704.     cell (a cell with no dependant references to it) is reached and the
  1705.     calculation sequence stops. This method is called AUTOMATIC
  1706.     recalculation, and is the default mode when AS-EASY-AS is first
  1707.     started.
  1708.  
  1709.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [29] 
  1710.     To activate AUTOMATIC recalculation press the following sequence of
  1711.     keys.
  1712.  
  1713.         /sgra
  1714.  
  1715.     Which stands for the following commands.
  1716.  
  1717.         Sheet, General, Recalc, Auto.
  1718.  
  1719.     In some cases, a linked recalculation sequence may require too much
  1720.     time to recalculate after entry of new data.  Therefore, the
  1721.     calculation sequence can be turned off while a series of changes are
  1722.     being made to the spreadsheet. This method is called MANUAL
  1723.     recalculation.  After the changes are completed, the spreadsheet may
  1724.     be updated by pressing the CALC function key [F9].
  1725.  
  1726.     To activate MANUAL recalculation press the following sequence of keys.
  1727.  
  1728.         /sgrm
  1729.  
  1730.     Which stands for the following commands:
  1731.  
  1732.         Menu, Sheet, General, Recalc, Manual.
  1733.  
  1734.     When manual recalculation has been selected, the indicator 'MAN' will
  1735.     appear on the status line.
  1736.  
  1737.  
  1738.     SAVING THE WORKSHEET
  1739.     ~~~~~~~~~~~~~~~~~~~~
  1740.     To save the entries you have made in the worksheet, press the [/] key
  1741.     to bring up the main menu.  Select the FILE command choice by pressing
  1742.     "F" or by moving the cursor to highlight that word and pressing
  1743.     [ENTER].  You will see a new menu of file command choices.
  1744.  
  1745.     If you wish to save the file to a drive or directory other than the
  1746.     default drive/directory, you must change the data directory to the
  1747.     desired drive. This can be done by selecting the FILE DIRECTORY
  1748.     command and typing in the new path.  The path can be changed by typing
  1749.     in the new path at the "PATH:" prompt.  You can also change the
  1750.     drive/directory when specifying the file name by including the path
  1751.     with the file name.
  1752.  
  1753.     If you are using a diskette to store your worksheets, make sure the
  1754.     diskette is in the specified drive.  You should always have a
  1755.     formatted disk with room for extra worksheet files available.
  1756.  
  1757.     Select the STORE command.  If the worksheet is new, you will be
  1758.     prompted for the name of your worksheet.  A name is valid if it has up
  1759.     to 8 characters and does not contain any of the following characters:
  1760.  
  1761.         ","     "*"     "/"     "?"     "#"     " "     "'"     "|"
  1762.  
  1763.     Confirm the typed name by pressing [ENTER].
  1764.  
  1765.  
  1766.  
  1767.  
  1768.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [30] 
  1769.     Examples of valid file name inputs:
  1770.  
  1771.         SAMPLE1            Saves data in SAMPLE1.WKS in current path
  1772.  
  1773.         \DATA\SAMPLE1      Saves data in file SAMPLE1.WKS. in directory
  1774.                            \DATA of the current drive.  A beep will sound
  1775.                            and an error message will appear if the
  1776.                            requested directory does not exist.
  1777.  
  1778.                            NOTE:       The default path will now be
  1779.                                        \DATA of the current drive.
  1780.  
  1781.         D:\MINE\SAMPLE1    Saves data in file SAMPLE1.WKS in directory
  1782.                            \MINE of drive D:
  1783.  
  1784.                            NOTE:       The default path will now be
  1785.                                        D:\MINE\
  1786.  
  1787.     If you try to save a worksheet that was previously retrieved from your
  1788.     current data disk, the name of that worksheet will automatically
  1789.     appear in the Name input field of the file window.  Pressing [ENTER]
  1790.     instructs the program to accept that name.
  1791.  
  1792.     If a worksheet with the same name already exists on your data disk,
  1793.     the program will ask if you want to "cancel", make a "backup" or
  1794.     "replace" the old file (on the disk) with the contents of the current
  1795.     worksheet in the computer.
  1796.  
  1797.     If you choose to make a backup, the file on disk will be renamed with
  1798.     the extension .WKB and the new file will be saved with an extension
  1799.     .WKS.
  1800.  
  1801.     NOTE: This method provides only a single level of bakckup protection.
  1802.           If you desire additional backups, it is recommended that you
  1803.           save your files using a number appended to the end of the file
  1804.           name, i.e., WORK1, WORK2, WORK3, etc.
  1805.  
  1806.  
  1807.     SAVING PART OF THE WORKSHEET
  1808.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1809.     Sometimes it may be appropriate to save only a small portion of the
  1810.     spreadsheet.  This may be achieved by using the /File Xport command.
  1811.  
  1812.     Once the Xport command has been selected, AS-EASY-AS will ask if you
  1813.     want to export to a WKS or a dBASE III file, and then it will prompt
  1814.     for the name of the file.  Type the name and press [ENTER].  Do NOT
  1815.     add an extension when you type the name as this is performed
  1816.     automatically by AS-EASY-AS.
  1817.  
  1818.     After you have specified the name of the file, the program asks for
  1819.     the range to be exported.  The range can be specified by either
  1820.     pointing or typing, or a range name can be used.
  1821.  
  1822.     The specified range will then be exported to either a .WKS or .DBF
  1823.     type file.
  1824.  
  1825.  
  1826.  
  1827.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [31] 
  1828.     RETRIEVING THE WORKSHEET
  1829.     ~~~~~~~~~~~~~~~~~~~~~~~~
  1830.     To retrieve a worksheet select the /File, Retrieve command.
  1831.  
  1832.     A window will open in the middle of the screen displaying worksheet
  1833.     files present in the default directory.  Only one page of names is
  1834.     displayed at a time.  To view subsequent pages press the [PGDN] or
  1835.     [PGUP] keys.
  1836.  
  1837.     Select your file by moving the pointer to highlight the file, or type
  1838.     the file name at the name prompt and then press [ENTER].  To change
  1839.     the path, you may type in the new path in the "PATH:" field, or
  1840.     include the path as part of the file name.  This new path will become
  1841.     the default path.
  1842.  
  1843.  
  1844.     COMBINING WORKSHEETS
  1845.     ~~~~~~~~~~~~~~~~~~~~
  1846.     The /FILE MERGE command will combine any designated worksheet file
  1847.     with the current file starting at the position occupied by the
  1848.     spreadsheet pointer.  The information merged from the new file will
  1849.     overwrite any information present in the cells.
  1850.  
  1851.     WARNING:   Information in cells overwritten cannot be recovered.
  1852.  
  1853.     When /File Merge is selected, choose either to merge the whole file or
  1854.     a named range from a specified file.  Once this choice has been made,
  1855.     you are asked to specify whether to merge the formulas in the named
  1856.     range or file or just the calculated values in the range.
  1857.  
  1858.     NOTE:   When the Merge-Range-Formulas is selected, the cell
  1859.             relationships are retained in the new worksheet.
  1860.  
  1861.     If a cell of the file being merged (from disk), contains a formula,
  1862.     and you selected /File, Merge, [All/Range], Value, then the last
  1863.     values contained in the cells when the worksheet was saved will be
  1864.     used in the merge operation.
  1865.  
  1866.     If you selected /File, Merge, [All/Range], Formula, then for cells in
  1867.     the file on disk that contained values, those values will be used in
  1868.     the merge operation.  For cells that contained formulas, however, the
  1869.     contents of the current cells will be replaced with the formulas from
  1870.     the file on disk.
  1871.  
  1872.     You will now be provided with three options for the merged
  1873.     information; ADD, DIFF, and REPLACE.
  1874.  
  1875.  
  1876.     ADD - will cause the cell contents of the file being merged to be
  1877.     added to the contents of the current file cells.
  1878.  
  1879.     DIFF - will cause the cell contents of the file being merged to be
  1880.     subtracted from the contents of the current file cells.
  1881.  
  1882.     REPLACE - will cause the cell contents of the file being merged to
  1883.     replace the contents of the current file cells.
  1884.  
  1885.  
  1886.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [32] 
  1887.     LEAVING THE WORKSHEET
  1888.     ~~~~~~~~~~~~~~~~~~~~~
  1889.     You have just completed your masterpiece spreadsheet and are now ready
  1890.     to call it quits for the day.  FIRST, MAKE SURE THAT YOU SAVED YOUR
  1891.     LATEST VERSION OF THE WORKSHEET (see previous section on saving your
  1892.     worksheet).
  1893.  
  1894.     Access the command menu by pressing the [/] key.  Select the EXIT
  1895.     command.  You will be given a second chance to change your mind when
  1896.     AS-EASY-AS asks if you want to quit, YES or NO.  Highlight the word
  1897.     YES or type the letter "y".  AS-EASY-AS will prompt you one last time,
  1898.     asking if you have saved your worksheet.  If you wish to return to the
  1899.     worksheet, press [ESC], otherwise press [ENTER].  The program will now
  1900.     return to DOS.
  1901.  
  1902.     If you performed the above keystrokes by accident and did not intend
  1903.     to leave the spreadsheet, you are out of luck because all spreadsheet
  1904.     information in the computer memory has been lost.
  1905.  
  1906.     Remember, save your data frequently as you work, and make back-up
  1907.     copies of your files!
  1908.  
  1909.     You can print any portion of the spreadsheet to either a PRINTER or a
  1910.     print FILE (on your disk) or append to a print file by selecting the
  1911.     "PrintTo" option from the main menu.
  1912.  
  1913.     If you are printing to a printer for the first time, you need to
  1914.     install your printer type.  This is done by the /User Install Printer
  1915.     command.  Once the selection is made, make sure to save your
  1916.     configuration file (see User Install for more information).
  1917.  
  1918.  
  1919.  
  1920.  
  1921.  
  1922.  
  1923.  
  1924.  
  1925.  
  1926.  
  1927.  
  1928.  
  1929.  
  1930.  
  1931.  
  1932.  
  1933.  
  1934.  
  1935.  
  1936.  
  1937.  
  1938.  
  1939.  
  1940.  
  1941.  
  1942.  
  1943.  
  1944.  
  1945.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [33] 
  1946.     4.  PRINTING
  1947.     ~~~~~~~~~~~~
  1948.     To get into the printer menu, press the following sequence of keys.
  1949.  
  1950.         /pp
  1951.  
  1952.     Which stands for /PrintTo Printer.
  1953.  
  1954.     You are now in the print menu where all the print variations are
  1955.     defined. You will see the following selections on the command line:
  1956.  
  1957.     Range  Border  LineFeed  PageAdv  Options  Adjust  Go  View  Quit
  1958.  
  1959.     Range       Stands for the rectangular area of the spreadsheet which
  1960.                 is to be printed.  This must be defined prior to printing.
  1961.     Border      Print specified row(s) and/or column(s) on every page of
  1962.                 the output.
  1963.     LineFeed    Advance the paper in the printer a single line.
  1964.     PageAdv     Advance the paper in the printer to the top of the next
  1965.                 page.
  1966.     Options     Allows access to Sub-menu of printer options; margins,
  1967.                 page length, header, footer, format type and printer setup
  1968.                 string. (See print menu explanations for further
  1969.                 details).
  1970.     Adjust      Synchronize the program's top-of-page with the printer
  1971.                 top-of-page.  The page and line counters are reset to 1.
  1972.                 Note:  If this synchronization is not done, you may get
  1973.                 several blank lines in the middle of the printed page.
  1974.                 This is the gap allotted to skip over sheet perforation.
  1975.     Go          Starts the printer printing.
  1976.     View        Preview the selected range before printing
  1977.  
  1978.     All print output is directed to the printer attached to the parallel
  1979.     port (LPT1).  To direct information to be printed to alternate ports
  1980.     use the Print, File command.  As an example, to send output to serial
  1981.     port #1 (COM1), type:
  1982.  
  1983.         /PrintTo File COM1 [ENTER]
  1984.  
  1985.     and execute the Adjust Go commands.
  1986.  
  1987.     NOTE:   You must preset the Baud Rate using the DOS MODE command.
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.  
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.  
  2003.  
  2004.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [34] 
  2005.     PRINTER BORDERS
  2006.     ~~~~~~~~~~~~~~~
  2007.     The PrintTo Printer Borders command allows you to select row(s) and/or
  2008.     column(s) from your worksheet that you wish to have printed on every
  2009.     page. This is especially useful for large multi-page spreadsheets
  2010.     where you need to have column headings or row descriptors printed on
  2011.     your output.  The Printer Borders command operates similar to Sheet
  2012.     Borders.
  2013.  
  2014.     The print range need not be adjacent to the borders you've selected.
  2015.     This allows you to print part of a ledger complete with row and column
  2016.     headings.
  2017.  
  2018.     When Printer Borders is used, you must be careful when specifying the
  2019.     ranges.  The rows and columns specified as your print border SHOULD
  2020.     NOT be included as part of your print range:  you may end up with
  2021.     duplicate rows or columns in your output.
  2022.  
  2023.     To clear Printer Borders, select None under the Borders menu.
  2024.  
  2025.  
  2026.     MARGINS & PAGE LENGTH - PRINTER OPTIONS
  2027.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  2028.     AS-EASY-AS default margin settings are 0 for the left margin and 80
  2029.     for the right margin.  Both margins are measured in characters from
  2030.     the left edge of the page.  Using the default settings, you are able
  2031.     to print a range of up to 80 characters wide.  Setting the left margin
  2032.     to 10 allows you to print a range 70 (80 minus 10), characters wide.
  2033.  
  2034.     If your spreadsheet will not fit across a page, AS-EASY-AS prints the
  2035.     left part (on a page) then prints the next section on a new page, and
  2036.     so on until the entire spreadsheet is printed.  You can combine these
  2037.     printed pages to create one wide spreadsheet.
  2038.  
  2039.     If you are using wide paper, or other than 10-pitch print, and you are
  2040.     printing more than 80 characters wide, you will need to change the
  2041.     right margin.
  2042.  
  2043.     If you've selected condensed print and your output continues to print
  2044.     additional pages while leaving a large right margin, chances are your
  2045.     right margin needs to be increased to accommodate the width of your
  2046.     print range.
  2047.  
  2048.     The print margins that can be set in AS-EASY-AS are described below:
  2049.  
  2050.     Page Length (0-1024) determines the number of lines printed on each
  2051.         page. The default, 66, is the correct setting for a printer that
  2052.         prints six lines per inch (the standard setting) on 11-inch paper.
  2053.         If your printer is set to a different lines-per-inch value, or if
  2054.         your paper is a different length, change this setting accordingly.
  2055.         To calculate the page length, multiply the lines-per-inch value by
  2056.         the number of inches on a page.  This setting is unaffected by
  2057.         headers, footers, or top or bottom margins.
  2058.  
  2059.     Left (0-240) determines the amount of space to leave between the left
  2060.         edge of the paper and the first column of data.  The default, 0,
  2061.         leaves no left margin.  Depending on the width of your
  2062.  
  2063.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [35] 
  2064.         spreadsheet, you may want to lengthen this margin.
  2065.  
  2066.     Top (0-30) determines the number of blank lines to leave at the top of
  2067.         each page.  The default, 2, leaves a margin of approximately one-
  2068.         half inch. If you include a header in your printout, it is printed
  2069.         underneath this margin with one blank line between it and the
  2070.  
  2071.     Right (0-240) determines the amount of space to leave for a right
  2072.         margin. spreadsheet data. This value is the number of spaces
  2073.         between the left edge of the paper and the beginning of the right
  2074.         margin - like the margin settings on a typewriter.  The default,
  2075.         80, begins the right margin at the 80th character space, leaving
  2076.         no right margin.
  2077.  
  2078.     Bottom (0-32) determines the number of blank lines to leave at the
  2079.         bottom of each page.  The default, 2, leaves approximately one-
  2080.         half inch.  If you include a footer in your printout, it is
  2081.         printed above this margin with one blank line between it and the
  2082.         spreadsheet data.
  2083.  
  2084.     In setting the correct page length for your printer, please note the
  2085.     following pointers:
  2086.  
  2087.         The default page length is set to 66 lines.  Most dot matrix
  2088.         printers default to 6 lines per inch, so no changes are required
  2089.         if you are printing on 11 inch long paper.  If you wish to change
  2090.         the lines per inch spacing to 8, you must also change the lines
  2091.         per page to 88 (8 lpi X 11 inches) for headers, footers, and page
  2092.         breaks to work properly.
  2093.  
  2094.         Some laserjet printers default to a value other than 66 lines per
  2095.         inch. If this is the case, you must adjust the page lines
  2096.         accordingly.
  2097.  
  2098.         If you have set your top and bottom margins equal to 0 and your
  2099.         page length equal to 66 lines, you are able to print a range of 60
  2100.         rows on a page before the program will skip to a new page.  One
  2101.         line at the top and bottom of the page is reserved for the perf-
  2102.         skip feature.  Two lines each are reserved for headers and
  2103.         footers; one for the line of text and the second line serves as a
  2104.         spacer between the header or footer and the body of the text.
  2105.  
  2106.     To figure out the correct number of lines that will be printed by AS-
  2107.     EASY-AS on a single page, do the following:
  2108.  
  2109.         Get the lines per page setting of your printer (for the current
  2110.         pitch and line spacing).  Note that this setting should match the
  2111.         page length setting specified in AS-EASY-AS.
  2112.  
  2113.         Subtract the AS-EASY-AS settings for top and bottom margin
  2114.  
  2115.         Subtract 4 lines (header, footer and lines between the header, the
  2116.         footer and the text body).
  2117.  
  2118.         Subtract 2 lines (top and bottom skip perforation).
  2119.  
  2120.  
  2121.  
  2122.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [36] 
  2123.     In other words, the number of text lines that will be printed on a
  2124.     single page is given by:
  2125.  
  2126.  
  2127.         Page Length - Top Margin - Bottom Margin - 4.
  2128.  
  2129.  
  2130.     INSERTING PAGE BREAKS
  2131.     ~~~~~~~~~~~~~~~~~~~~~
  2132.     AS-EASY-AS automatically inserts page breaks where needed (as
  2133.     specified by the Pagelength command setting).  You may also specify
  2134.     "hard page breaks", i.e., force a page break, manually, using one of
  2135.     two methods.
  2136.  
  2137.         By typing a hard page break into the first cell of a blank row.
  2138.         The hard page break is the vertical piping character, followed by
  2139.         two colons (|::). If there is any other data in that row it will
  2140.         be ignored.
  2141.  
  2142.         By using the /Sheet Insert Page command while in the left most
  2143.         cell of the print range.  This command sequence automatically
  2144.         inserts a blank row and the "|::" character sequence for you.
  2145.  
  2146.     NOTE: The hard page break character sequence must be placed in the
  2147.           left-most column of the print range in order to be recognized by
  2148.           AS-EASY-AS.
  2149.  
  2150.  
  2151.     PRINTER OPTIONS - HEADERS & FOOTERS
  2152.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  2153.     Centering headers and footers can be performed by separating pieces of
  2154.     text with the "|" character. i.e., if you have the following in your
  2155.     header line:
  2156.  
  2157.         PAGE|TITLE|DATE
  2158.  
  2159.     This will be translated into:
  2160.  
  2161.     PAGE                    TITLE                       DATE
  2162.  
  2163.     The first word, "PAGE", is left justified since it is not preceded by
  2164.     a "|" character.
  2165.  
  2166.     The second word, "TITLE", is centered since it is preceded by the
  2167.     first "|" character.
  2168.  
  2169.     The third word, "DATE", is right justified since it is preceded by the
  2170.     second "|" character.
  2171.  
  2172.     -  Sequential page numbering can be achieved by placing the "#"
  2173.        character in the header/footer line.
  2174.  
  2175.     -  Placement of the current date on the top/bottom of a printed page
  2176.        can be achieved by placing the "@" character in the header/footer
  2177.        line.
  2178.  
  2179.  
  2180.  
  2181.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [37] 
  2182.     PRINTER OPTIONS - EMBEDDED CODES
  2183.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  2184.     You can place text enhancement printer control codes directly into a
  2185.     print range.  This can be achieved by placing:
  2186.  
  2187.         |\xxx\yyy
  2188.  
  2189.     in the first column of the print range, where xxx and yyy are your
  2190.     printer's control codes.
  2191.  
  2192.     For example, if your print range was A1 to H20, by putting the
  2193.     following in the FIRST column (A1) of the print range,
  2194.  
  2195.      |\027\069   (This is the setup string for emphasized print on an EPSON
  2196.             printer.  Note that the prefix character [|] will not be
  2197.             displayed).
  2198.  
  2199.     the result is emphasized text on an Epson printer.
  2200.  
  2201.     NOTE:  Any remaining data on line containing the printer control
  2202.            codes will not be printed.  An entire line may be hidden
  2203.            during printing if a single "|" is placed in the first column.
  2204.  
  2205.     If you try to enter text-enhancing control codes inside a label,
  2206.     you'll find that when you enter Alt 027, you exit the edit mode.
  2207.     That's because control characters (ASCII less than 32), are translated
  2208.     by the program into special editing keys such as Arrow keys, [ESC]
  2209.     key, etc.
  2210.  
  2211.     To enter control characters, you need to use the Edit Bypass Function
  2212.     key, [F3].  The sequence is:  F3 Alt nnn.  F3 is only active for one
  2213.     control character and must be pressed every time additional control
  2214.     characters are to be embedded.
  2215.  
  2216.     For example, if you want to print "This is a CONTROL code sample" on
  2217.     an EPSON  printer with only the word "CONTROL" in condensed mode, the
  2218.     following keystrokes should be used:
  2219.  
  2220.     This is a F3 [Alt] 015 CONTROL F3 [Alt] 018 code sample.
  2221.  
  2222.     The 015 code turns the condensed print mode on and the 018 code turns
  2223.     the condensed print mode off.
  2224.  
  2225.     Page breaks can be forced by placing a single "|" followed by two
  2226.     colons "::" in your text.  This must be placed in a cell that is in
  2227.     the left-most column of your print range.  Information in cells to the
  2228.     right of the page break command will not be printed.
  2229.  
  2230.     A page break can also be inserted into your worksheet by using the
  2231.     following command:
  2232.  
  2233.         /Sheet Insert Page
  2234.  
  2235.     This command will insert a new row and place "|::" in the cell at the
  2236.     current cursor location.
  2237.  
  2238.  
  2239.  
  2240.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [38] 
  2241.     PRINTER OPTIONS - TYPE
  2242.     ~~~~~~~~~~~~~~~~~~~~~~
  2243.     The output can be printed (to printer or file) in one of the following
  2244.     formats.
  2245.  
  2246.      AS SEEN    Prints the output in row and column format (as
  2247.                 displayed on screen) with headers, footers, and page
  2248.                 breaks.
  2249.  
  2250.      CONTENTS   Prints a columnar listing of all non-blank cells and their
  2251.                 contents.  Useful for printing cell formulas and
  2252.                 documentation of calculation templates.
  2253.  
  2254.      NOFORM     Prints the output without header and footer information
  2255.                 and suppresses page breaks.
  2256.  
  2257.  
  2258.     CONTROLLING THE PRINTER
  2259.     ~~~~~~~~~~~~~~~~~~~~~~~
  2260.     Most printers can be controlled by sending a sequence of ASCii control
  2261.     codes to your printer.  (For details and control codes, refer to your
  2262.     printer's user's manual).
  2263.  
  2264.     Commonly used codes for the EPSON series of printers are:
  2265.  
  2266.         \027\069    Turn on  Emphasized text (or \027E)
  2267.         \027\070    Turn off Emphasized text (or \027F)
  2268.         \015        Turn on  Condensed  text
  2269.         \018        Turn off Condensed  text
  2270.  
  2271.  
  2272.     The three digit number 027 stands for the [escape] code and the three
  2273.     digit number 069 stands for the capital letter 'E'.
  2274.  
  2275.     Printer codes may be entered by selecting PrintTo Printer Options
  2276.     Setup. The spreadsheet accepts codes only if they are separated by the
  2277.     back-slash character [\] .  To select the emphasized text mode, type
  2278.     the following in response to the prompt for the setup string (remember
  2279.     to use 3 digits):
  2280.  
  2281.         \027\069   [enter]
  2282.  
  2283.     To change the string, re-select the SETUP option.
  2284.  
  2285.     ASEASY.PRT
  2286.     ~~~~~~~~~~
  2287.     To make life easier so you don't have to manually enter printer setup
  2288.     codes or look up an infrequently used setup code, simply type the [\]
  2289.     character when entering a printer setup code and press F1.
  2290.  
  2291.     A listing of predefined setup codes from ASEASY.PRT will pop-up in a
  2292.     pick window on your screen.  By highlighting the desired function, the
  2293.     appropriate printer code will be entered into the setup string.
  2294.  
  2295.     Any control codes supported by your printer can be incorporated in the
  2296.     file ASEASY.PRT, an ASCII text file, which has the following
  2297.     structure:
  2298.  
  2299.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [39] 
  2300.       - Each control code consists of two lines.
  2301.  
  2302.       - The first line contains a description of the print enhancement
  2303.         (eg. Emphasized, Underline, ....).  Description  names should not
  2304.         be separated by spaces,  e.g. 'Dbl_Strike'  NOT  'Dbl Strike'.
  2305.         Note that this description name must not exceed 11 characters.
  2306.  
  2307.       - The second line contains the decimal setup code for the described
  2308.         print enhancement.
  2309.  
  2310.             e.g.   027\015    -  condensed for EPSON printers
  2311.  
  2312.  
  2313.     NOTE: There is no leading backslash in the setup codes in the
  2314.           ASEASY.PRT file (i.e.  027\015,  NOT \027\015)
  2315.  
  2316.     You can create or edit ASEASY.PRT with any word processor/text editor
  2317.     that generates ASCII files.
  2318.  
  2319.     Let's say you want to incorporate the following codes supported by
  2320.     your EPSON compatible printer in an ASEASY.PRT file:
  2321.  
  2322.         Decimal Control Codes             Print            ASEASY.PRT
  2323.         From Printer User's Manual      Enhancement            Code
  2324.         ~~~~~~~~~~~~~~~~~~~~~~~~~~      ~~~~~~~~~~~         ~~~~~~~~
  2325.             27, 77                      Elite Pitch         027\077
  2326.             27, 72                      Double Strike       027\072
  2327.             27, 69                      Emphasized          027\069
  2328.  
  2329.     The ASEASY.PRT file generated for the codes should look something like
  2330.     the one presented below:
  2331.  
  2332.         Elite           <-----   First line of the file
  2333.         027\077                     .  (Up to 240 characters long)
  2334.         Dbl_strike                  .
  2335.         027\072                     .
  2336.         Emphasized                  .
  2337.         027\069         <-----   Last  line of the file
  2338.  
  2339.  
  2340.     PRINT TO A FILE
  2341.     ~~~~~~~~~~~~~~~
  2342.     To create an ASCII file (which contains the print range) for transfer
  2343.     to other programs (like databases or word processors) use the
  2344.     following procedure.
  2345.  
  2346.     Type:   /pfTEST   [ENTER]
  2347.  
  2348.     Which stands for /PrintTo File.  At this point the program asks for
  2349.     the name of the print file.  Type the name of the print file (in this
  2350.     case TEST) and press ENTER.  If no extension is specified, an
  2351.     extension of ".PRN" will automatically be attached to the file name.
  2352.     If you have already sent output to the print file during the current
  2353.     AS-EASY-AS session, the name of the print file will appear at the
  2354.     prompt line.  You can select it by just pressing ENTER.
  2355.  
  2356.     If you wish to append an existing ASCII print file, select /PrintTo
  2357.  
  2358.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [40] 
  2359.     Append. This command will print the selected range to the end of the
  2360.     specified print file.
  2361.  
  2362.  
  2363.     PRINTING COMBINED TEXT AND GRAPHICS
  2364.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  2365.     AS-EASY-AS has the ability to print combined spreadsheet data and
  2366.     graphs on dot matrix and laserjet printers.  To print a graph from
  2367.     spreadsheet data, you must have first created the graph and formatted
  2368.     a range to display the graph (see Section 5.4, Combining Text and
  2369.     Graphics).
  2370.  
  2371.     To print the combined data graph, first select /PrintTo Graphics.
  2372.     Select Range and highlight the area you would like to print.  Make
  2373.     sure the entire graph is contained within the print range.
  2374.  
  2375.  
  2376.  
  2377.     USING PRINT VIEW
  2378.     ~~~~~~~~~~~~~~~~
  2379.     It is possible to preview the layout and organization of data, page
  2380.     breaks and margin settings in the spreadsheet through the use of the
  2381.     view command. AS-EASY-AS will display either a full page of text (by
  2382.     pressing [F2]) or a 200% zoom of a half page (by pressing [F1]).
  2383.  
  2384.     To advance through the print range use the [PGUP] or [PGDN] keys.  Any
  2385.     graphs inserted will be displayed in their correct position on the
  2386.     page.
  2387.  
  2388.  
  2389.  
  2390.  
  2391.  
  2392.  
  2393.  
  2394.  
  2395.  
  2396.  
  2397.  
  2398.  
  2399.  
  2400.  
  2401.  
  2402.  
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [41] 
  2418.  
  2419.     5  GRAPHICS COMMANDS
  2420.     ~~~~~~~~~~~~~~~~~~~~
  2421.     AS-EASY-AS provides you with the capability to create high-quality
  2422.     graphs from your spreadsheet data.  Hardcopy output can be generated
  2423.     on 9- or 24-pin dot matrix printers, laserjet printers.  A .PIC file
  2424.     can be created for use with your word processing or graphics programs.
  2425.  
  2426.     Thirteen types of graphics can be created:
  2427.  
  2428.         X-Y             Bar                 Delta           Area
  2429.         Line            Stacked Bar         Cumulative      HLoc
  2430.         Polar           Strip               Wall            Pie
  2431.         Radar
  2432.  
  2433.     Many options are available to customize graphs for business graphics
  2434.     as well as for engineering and scientific analyses, etc.  Titles and
  2435.     legends can be added with user-specified type size.  The user can also
  2436.     specify fill patterns, colors, line styles, and tick mark styles.
  2437.  
  2438.     Graphs can be scaled on both the X (horizontal) axis and the Y
  2439.     (vertical) axis so that the entire graphed range (or a portion of the
  2440.     range) may be displayed.  A logarithmic adjustment to either or both
  2441.     of the X and Y scales may be performed to produce semi-log or log-log
  2442.     graphs.
  2443.  
  2444.     All data points are specified by ranges in the spreadsheet.  Up to six
  2445.     curves may be displayed on a single graph, with an additional six if
  2446.     two graphs are merged.
  2447.  
  2448.     The following provides details on the graphics commands to allow
  2449.     you to create customized graphs.
  2450.  
  2451.  
  2452.  
  2453.     GRAPH RANGES
  2454.     ~~~~~~~~~~~~
  2455.     Specify the X range and up to six Y ranges (A through F) for the
  2456.     graph. Ranges can be specified either by the pointing or typing
  2457.     method, or by using a predefined range name.
  2458.  
  2459.     A basic difference between X-Y type graphs and other types of graphs
  2460.     should be remembered.  Line graphs and bar graphs represent a set of
  2461.     values as vertical distances.  The only numeric scale in this type of
  2462.     graph is the one along the vertical axis.  The horizontal axis
  2463.     displays all items in the X range in a non-numeric, equally spaced
  2464.     sequence of text, (e.g. dates, names of cities, etc.).
  2465.  
  2466.     The X-Y type graphs are two-dimensional.  They represent pairs of
  2467.     values as a function of their horizontal and vertical coordinates.
  2468.  
  2469.     Note that there should be a one-to-one correspondence between the
  2470.     elements of the X-range and Y-range(s).
  2471.  
  2472.  
  2473.  
  2474.  
  2475.  
  2476.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [42] 
  2477.     LABELS
  2478.     ~~~~~~
  2479.     Define a range of labels that are to be used to mark each of the data
  2480.     points on the specified graph range.  A one-to-one correspondence is
  2481.     needed between the range being plotted and the labels for that range.
  2482.     The data labes may be placed Above, Below, to the Left or to the Right
  2483.     of the data points.
  2484.  
  2485.  
  2486.     CUSTOM OPTIONS
  2487.     ~~~~~~~~~~~~~~
  2488.     Customize the colors of the graph series, and the inner and outer
  2489.     portions of the graph in one of 16 colors.  The following colors are
  2490.     available (on monitor/card combinations that support them):  Black,
  2491.     MidBlue, Green, Cyan, Red, Magenta, Brown, Gray, Smokey, Blue,
  2492.     HiGreen, LightBlue, Scarlet, Violet, Yellow,  and White.  Each data
  2493.     range may be assigned a color.  In addition, the following colors may
  2494.     be specified:
  2495.  
  2496.       INNER: Color of the graph screen.
  2497.       OUTER: Outer color of the graph screen.
  2498.       TITLE: Title color of the graph screen.
  2499.       VALUE: X- and Y-Axis scale labels.
  2500.  
  2501.  
  2502.     LEGEND
  2503.     ~~~~~~
  2504.     Set the graph legend and its location.  An input window is used to
  2505.     display the legend options.  The Legend option allows the user to
  2506.     enter text which describe the ranges of A through F.  Legends may be
  2507.     placed below the graph (Line) or to the right of the graph (Box).
  2508.  
  2509.  
  2510.     TITLES
  2511.     ~~~~~~
  2512.     Specify the title strings on graph.  The Main title, Second title and
  2513.     X and Y axes titles may be entered. Preceding the main title with the
  2514.     "#" character will create a framed title box.
  2515.  
  2516.  
  2517.     GRID
  2518.     ~~~~
  2519.     Select a horizontal and/or vertical grid at each scale division on
  2520.     your graph with a solid or dotted line.  Other options include
  2521.     specifying a dotted or a solid grid line, and whether or not to use
  2522.     grid lines for the minor axis divisions.
  2523.  
  2524.  
  2525.     FONT SIZE
  2526.     ~~~~~~~~~
  2527.     Relative size of the font used in graph titles, legends, values, and
  2528.     labels.  The size is a scale factor based on a fraction centered
  2529.     around 1.0.  For example, the default value for the main title is 1.5,
  2530.     meaning the font is 1.5 times the base font size.
  2531.  
  2532.  
  2533.  
  2534.  
  2535.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [43] 
  2536.  
  2537.     The text sizes which may be changed, along with their default values,
  2538.     are listed below:
  2539.  
  2540.     MAIN            1.5           LEGEND          0.75
  2541.     SECOND          1.0           VALUES          0.75
  2542.     X-AXIS          1.0           LABELS          0.75
  2543.     Y-AXIS          1.0
  2544.  
  2545.  
  2546.     CLEAR
  2547.     ~~~~~
  2548.     Reset all the options for the entire graph or for a selected range
  2549.     back to the default settings.
  2550.  
  2551.  
  2552.     NAME
  2553.     ~~~~
  2554.     This option allows you to define multiple graphs and associated
  2555.     settings and titles in a single worksheet.  One named graph may be
  2556.     superimposed on the main graph, or they may be displayed as two
  2557.     separate graphs, one above the other.  You also insert a graph into
  2558.     the worksheet.
  2559.  
  2560.     INSERT
  2561.       Place either the MAIN or a named graph into the spreadsheet.  The
  2562.       range enclosing the inserted graph appears in a highlighted color.
  2563.  
  2564.       The upper left cell of the range contains the graph name and the
  2565.       size of the display in columns and rows.  For example, "MAIN:2,7"
  2566.       will display the main (or current) graph in a range 2 columns wide
  2567.       and 7 rows deep.  The cell may be edited to change the name and size
  2568.       of the graph if desired.
  2569.  
  2570.       The inserted graph will only be visable when it can fit entirely on
  2571.       the screen when previewing a print range with (PrintTo, Printer,
  2572.       View) and the page contains a graph.
  2573.  
  2574.       To print combined worksheet text and graphics see Section 5.4,
  2575.       Combining Text and Graphics.
  2576.  
  2577.       To update the graph after changing graphed data, you must manually
  2578.       recalculate the spreadsheet by pressing the [F9] calc function key.
  2579.  
  2580.     USE
  2581.       Select one of the previously named graphs and make it the current
  2582.       graph.  All current settings are replaced with the named graph's
  2583.       settings.
  2584.  
  2585.     CREATE
  2586.       Create a named graph which saves the current graph settings.
  2587.  
  2588.     DELETE
  2589.       Delete one of the previously named graph settings.
  2590.  
  2591.  
  2592.  
  2593.  
  2594.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [44] 
  2595.     MERGE
  2596.       Merge two graphs [Viewing ONLY!] (a NAMED graph and the currently
  2597.       defined graph).  The NAMED graph will be superimposed on top of the
  2598.       MAIN graph and it will be scaled on the right side of the graph.  It
  2599.       can have its own set of scaling factors, limits, formats, etc.
  2600.  
  2601.       To disable the merge feature select  /Graphics, Name, Merge, Reset
  2602.  
  2603.  
  2604.     SPLIT
  2605.       Shows two graphs on the same screen.  The top graph is the graph
  2606.       currently defined (MAIN).  The second, named graph, occupies the
  2607.       bottom half (similar to the Graphics, Name, Merge Option).  Each
  2608.       graph will have its own set of scaling factors, limits, formats,
  2609.       etc.
  2610.  
  2611.       NOTE: To disable the split feature select:  /Graphics,
  2612.             Name, Reset
  2613.  
  2614.     RESET
  2615.       Reset the merge or split option so that only the main graph will be
  2616.       displayed.
  2617.  
  2618.  
  2619.     VIEW
  2620.     ~~~~
  2621.     View the graph currently defined.  The resolution depends on your
  2622.     graphics board:
  2623.  
  2624.         CGA         640 x 200  pixels, 2 colors
  2625.         Hercules    720 x 348  pixels, 2 colors
  2626.         EGA         640 x 350  pixels, 16 colors
  2627.         AT&T        640 x 400  pixels, 2 colors
  2628.         VGA         640 x 480  pixels, 16 colors
  2629.  
  2630.     NOTE:  Graphs cannot be viewed on a system having a non-Hercules
  2631.            monochrome display adapter.  If a message is received
  2632.            indicating a graph cannot be displayed because of an invalid
  2633.            monitor type, and you have one of the above graphics
  2634.            boards, AS-EASY-AS may not have auto detected the
  2635.            graphics card properly.
  2636.  
  2637.            Save your worksheet and restart the program with the
  2638.            appropriate command line switch found in Section 2.3,
  2639.            Starting the Program.
  2640.  
  2641.  
  2642.  
  2643.     [PLOT] IMAGE
  2644.     ~~~~~~~~~~~~
  2645.     Specify the height and width for the graph.  Dimensions are in inches.
  2646.  
  2647.     HIGH
  2648.       Specify the vertical dimension of the graph to be generated on the
  2649.       printer.
  2650.  
  2651.  
  2652.  
  2653.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [45] 
  2654.     WIDE
  2655.       Specify the horizontal dimension width of the graph to be generated
  2656.       on the printer.
  2657.  
  2658.       NOTES: 1.  To adjust the left margin, which is the
  2659.                  distance between the left side of the paper and
  2660.                  the Y-scale title, use /PrintTo Printer Options
  2661.                  Margin Left.
  2662.  
  2663.              2.  To create a top margin, you must use
  2664.                  /PrintTo Printer and select Line several times
  2665.                  until the desired top margin has been created.
  2666.  
  2667.     PORTRAIT
  2668.       Print graph oriented at zero degrees.
  2669.  
  2670.     LANDSCAPE
  2671.       Rotate output of the graph 90 degrees.
  2672.  
  2673.     DRAFT
  2674.       Specify single pass or low density mode for the printer. Selecting
  2675.       this option is recommended for plotting draft graphs because the
  2676.       printing speed is about twice as fast as NLQ.
  2677.  
  2678.     NLQ
  2679.       Specify a high resolution print option.  This option will produce a
  2680.       dark, high quality graph.
  2681.  
  2682.  
  2683.     COMBINING TEXT AND GRAPHICS
  2684.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  2685.     AS-EASY-AS can include graphs within your spreadsheet for printing
  2686.     combined data and graphics.  Create a graph as discussed previously.
  2687.     Select /Graphics Name Insert, and highlight the area in which the
  2688.     graph is to be placed (see Graphics Name Insert in this Section for
  2689.     more information).
  2690.  
  2691.     The formatted range appears in a highlighted color.  The upper left
  2692.     cell of the range contains the graph name and the size of the display
  2693.     in columns and rows.  The cell may be edited to change the size of the
  2694.     graph if desired.
  2695.  
  2696.     The graph will appear when previewing (PrintTo, Printer, View) the
  2697.     page containing the graph.  To print text and graphics together, see
  2698.     Section 3, Printing Text and Graphics.
  2699.  
  2700.  
  2701.     SAVING A GRAPH
  2702.     ~~~~~~~~~~~~~~
  2703.  
  2704.     When a spreadsheet is saved, the current graph settings and named
  2705.     graph settings are saved with it.  When the file is retrieved, those
  2706.     graph settings are retrieved as well.  The user can then view the
  2707.     current graph by either pressing the [F10] function key from the ready
  2708.     mode, or by selecting the /Graphics, View command.
  2709.  
  2710.     Sometimes more than one graph might need to be created from the data
  2711.  
  2712.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [46] 
  2713.     in a worksheet.  That's no problem.  Instead of having to re-specify
  2714.     the settings every time you want to look at a previous graph, you can
  2715.     use the /Graphics, Name, Create and Use commands.
  2716.  
  2717.     When the /Graphics, Name, Create command is invoked, the program saves
  2718.     the current graph settings under the user specified name.  To select
  2719.     and view a named graph, select the /Graphics, Name, Use command and
  2720.     select or type the desired graph name.  The selected graph becomes the
  2721.     current or MAIN graph.
  2722.  
  2723.  
  2724.  
  2725.  
  2726.  
  2727.  
  2728.  
  2729.  
  2730.  
  2731.  
  2732.  
  2733.  
  2734.  
  2735.  
  2736.  
  2737.  
  2738.  
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746.  
  2747.  
  2748.  
  2749.  
  2750.  
  2751.  
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.  
  2758.  
  2759.  
  2760.  
  2761.  
  2762.  
  2763.  
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.  
  2770.  
  2771.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [47] 
  2772.     6. DATA COMMANDS
  2773.     ~~~~~~~~~~~~~~~~
  2774.     In addition to the typical spreadsheet format, AS-EASY-AS includes
  2775.     powerful DATA commands which enhance your ability to create
  2776.     sophisticated data management applications, what-if tables, etc.
  2777.  
  2778.  
  2779.     DATA FILL
  2780.     ~~~~~~~~~
  2781.     The Data-Fill command allows you to fill a range with an arithmetic
  2782.     sequence of equally spaced values.
  2783.  
  2784.     For example, assume that you want to fill a range of cells with real
  2785.     values that range from 3 to 43 in increments of two.
  2786.  
  2787.     Move the cursor to the beginning of the range.  Invoke the Data-Fill
  2788.     command (/df), enter range to fill, the starting value (in this case
  2789.     3), and the increment value (2).
  2790.  
  2791.  
  2792.     DATA TABLE
  2793.     ~~~~~~~~~~
  2794.     DATA TABLE - 1 INPUT
  2795.     ~~~~~~~~~~~~~~~~~~~~
  2796.     The Data Table-1 Input command permits you to do 'what-if' analysis by
  2797.     generating a table based on substituted values in an input cell.
  2798.  
  2799.     This command takes the input value from the first column, places the
  2800.     value in the model, calculates a result, extracts that value and
  2801.     places it in the table to the right of the input value.  The process
  2802.     is continued until the bottom of the table range is reached.
  2803.  
  2804.     For example, suppose that you want to borrow $1 million to start a new
  2805.     business.  Since you could borrow money from a number of different
  2806.     institutions with different interest rates, you want to compare your
  2807.     monthly payments for  different interest rates.  The payback period is
  2808.     10 years.
  2809.  
  2810.     To generate the comparison table, follow these steps:
  2811.  
  2812.         Enter the amount you want to borrow in cell B1
  2813.         Enter the starting interest rate in cell B2
  2814.         Enter the term of the loan (years) in cell B3
  2815.  
  2816.     Generate the following labels (using the /Range, Name, Create command,
  2817.     see Section 10) to help you identify the various inputs:
  2818.  
  2819.         Cell  B1  -  PRINCIPAL
  2820.         Cell  B2  -  INTEREST
  2821.         Cell  B3  -  TERM
  2822.  
  2823.     Enter the payment equation in cell B4:
  2824.  
  2825.         @PMT(PRINCIPAL,INTEREST/12,TERM*12)
  2826.  
  2827.     NOTE: INTEREST/12 and TERM*12 are used to obtain payments
  2828.           on a monthly basis.
  2829.  
  2830.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [48] 
  2831.     Generate a column of interest rates in this example ranging from 9% to
  2832.     10.1% in cells A8 to A19.
  2833.  
  2834.     Tell the program which value to extract and place in the table by
  2835.     entering a reference to the payment formula (cell B4) in cell B7
  2836.     (+B4).
  2837.  
  2838.     Now you are ready to generate the desired table using the following
  2839.     commands:
  2840.  
  2841.       /dt1       -  Data, Table, 1-input
  2842.       A7..B19
  2843.       [ENTER]    -  The table range (it includes the input values that you
  2844.                     want to vary and the locations that you want the
  2845.                     calculated result to be placed in).
  2846.       B2         -  The input cell. This will be the value that will change
  2847.                     after each calculation, and it is the value that we want
  2848.                     to extract.
  2849.  
  2850.      NOTE:  Multiple extractions are allowed providing each output
  2851.             column has a cell reference at the top.
  2852.  
  2853.  
  2854.  
  2855.     DATA TABLE - 2 INPUTS
  2856.     ~~~~~~~~~~~~~~~~~~~~~
  2857.     Now, let's say that you want to generate a comparison table varying
  2858.     both the interest and the term of the loan.
  2859.  
  2860.     Leave the column containing the interest rates (A8..A19) unchanged.
  2861.     Place the different terms (number of years) that you desire in row 7
  2862.     (one entry in each column).  Place 10 in cell B7, 20 in cell C7 and 30
  2863.     in cell D7.  Enter the formula +B4 in cell A7 (this tells the program
  2864.     what cell you want to extract values from).  Now enter the following
  2865.     keystrokes:
  2866.  
  2867.         /dt2             -  Data, Table, 2-inputs
  2868.         A7..D19 [ENTER]  -  Table range
  2869.         B1 [ENTER]       -  First input (Interest rate will vary)
  2870.         B3 [ENTER]       -  Second input (Term will vary)
  2871.  
  2872.  
  2873.     DATA SORT
  2874.     ~~~~~~~~~
  2875.     The Data Sort command is used to rearrange the information in a
  2876.     worksheet in alphabetical or numerical order.  The sorting process
  2877.     operates on rows. Let's look at the following example.
  2878.  
  2879.     Assume that the range B4 to D15 contains some student informations as
  2880.     follows:
  2881.  
  2882.        column B - last name
  2883.        column C - first name
  2884.        column D - grade
  2885.  
  2886.     It would be nice to sort this information by the students' last name
  2887.     or by grade.
  2888.  
  2889.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [49] 
  2890.     The following steps will sort the information by the students' last
  2891.     names (only).  Four sorting criteria can be specified (i.e. four
  2892.     different columns). This would be very useful in cases where, for
  2893.     example, two students had the same last name or two students had
  2894.     the same grade, i.e. a tie-breaker.
  2895.  
  2896.     1.  /ds               -   Invoke the Data, Sort menu
  2897.     2.  d                 -   Invoke the D-Range command to specify the
  2898.                               range to be sorted
  2899.     3.  B4..D15 [ENTER]   -   Specify the range to be sorted
  2900.     4.  p                 -   Invoke command to select the Primary sort key
  2901.                               (column)
  2902.     5.  B4 [ENTER]        -   Select Primary sort key.  Any cell in column B
  2903.                               would select Last Name as the primary sort key.
  2904.     6.  a [ENTER]         -   Accept the default, ascending order.  Typing d
  2905.                               [ENTER] would select descending order.
  2906.     7.  s                 -   Invoke command to select the Secondary sort
  2907.                               key (column)
  2908.     8.  D4 [ENTER]        -   Select Secondary sort key.  Any cell in column D
  2909.                               would select Grade as the secondary sort key.
  2910.     9.  a [ENTER]         -   Accept the default, ascending order.  Typing d
  2911.                               [ENTER] would select descending order.
  2912.     10. g                 -   Select Go to perform the sort.
  2913.  
  2914.     To sort on any other field (column), simply type in a new primary/
  2915.     secondary column.
  2916.  
  2917.  
  2918.     DATA BIN
  2919.     ~~~~~~~~
  2920.     The Data Bin command creates a frequency distribution table displaying
  2921.     the count of values in a range that falls within given ranges, bins,
  2922.     as well as the frequency of values within that range.  The bins are a
  2923.     block of values, in ascending order, placed anywhere in the worksheet.
  2924.  
  2925.     The requirements for setting up the bins are:
  2926.  
  2927.      1.   The bin values are contained in a single column block, and
  2928.  
  2929.      2.   There are two blank columns directly to the right of the bin
  2930.           range.  (This is the area that will be filled by the /db
  2931.           command).
  2932.  
  2933.     Once this command is invoked, the user is prompted to supply the
  2934.     "Analysis" range and the "Bin" range.
  2935.  
  2936.     ANALYSIS range, as the name indicates, is the range containing the
  2937.     values that the user needs to perform the frequency distribution on.
  2938.     BIN range is the column containing the bin (group) values, with two
  2939.     blank columns to the right.
  2940.  
  2941.  
  2942.  
  2943.  
  2944.  
  2945.  
  2946.  
  2947.  
  2948.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [50] 
  2949.     DATA GOALSEEK
  2950.     ~~~~~~~~~~~~~
  2951.     The Data Goalseek command allows you to search for the input that
  2952.     would result in a desired output from a model.  Specify the INPUT
  2953.     cell, the OUTPUT cell and the DESIRED goal and AS-EASY-AS modifies the
  2954.     input cell by using a NEWTON-RAPHSON convergence technique until the
  2955.     specified output is reached.  If the desired result has not been
  2956.     reached by 25 iterations, the process stops, and the value plus @ERR
  2957.     is placed in the input cell.  If this happens try choosing an input
  2958.     closer to the desired input.
  2959.  
  2960.     When prompted for the desired goal, AS-EASY-AS requires you specify
  2961.     the tolerance limit.  You should be aware that the more restrictive
  2962.     (smaller) the tolerance is, the longer it will take the program to
  2963.     converge to the correct answer.
  2964.  
  2965.     For example try the following situation:
  2966.  
  2967.     You want to borrow $100,000 for 30 years, and you don't want your
  2968.     monthly payments to exceed $1,028.61.  You want to determine the loan
  2969.     interest rate which would meet the above restrictions.
  2970.  
  2971.     The steps required to solve this problem are presented below:
  2972.  
  2973.     a.  Enter the Loan amount in cell A1  -->  100000
  2974.     b.  Enter a reference interest rate in cell A2 (i.e. if you start with
  2975.         an annual interest of 18%, enter 0.18)
  2976.     c.  Enter the term of the loan (30 * 12 = 360 months) in cell A3.
  2977.     d.  Enter the Payment equation in cell A4 - @PMT(A1,A2/12,A3)
  2978.     e.  Invoke the DATA, GOALSEEK command
  2979.     f.  Specify cell A2 as the INPUT cell
  2980.     g.  Specify cell A4 as the OUTPUT cell
  2981.     h.  Specify 1028.61 as the DESIRE
  2982.     i.  Specify a tolerance of 0.001
  2983.  
  2984.     Cell A4 will display the amount you specified as the desired monthly
  2985.     payment (if solution convergence occurred), and cell A2 will display
  2986.     the interest rate required for the load to meet your restrictions,
  2987.     0.12 (or 12%).
  2988.  
  2989.  
  2990.  
  2991.     DATA REGRESSION
  2992.     ~~~~~~~~~~~~~~~
  2993.     The Data Regress command allows you to determine the coefficients
  2994.     which correspond to a least squares fit of a straight line to a set of
  2995.     X and Y data.
  2996.  
  2997.     Assume that you have a range of data as follows:
  2998.  
  2999.           A4..A9   -   X-Values
  3000.           B4..B9   -   Y-Values
  3001.  
  3002.     Now follow the sequence of keystrokes presented below:
  3003.  
  3004.         /drxA4..A9~yB4..B9~oD4~
  3005.  
  3006.  
  3007.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [51] 
  3008.     This will invoke the Data Regress command.  The program will prompt
  3009.     for the X (or independent) range, (A4..A9), the Y (or dependent)
  3010.     range, (B4..B9), and the location that you want the output to be
  3011.     placed, (D4).
  3012.  
  3013.     The Y-Intercept and slope of a straight line going through the data
  3014.     points will then be entered in cells D4 and D5.  Additionally, values
  3015.     for R squared, the sum of the X squared values, the sum of the Y
  3016.     squared values, and the sum of the X*Y values, X and Y standard
  3017.     deviations, Slope error, and count sample are also entered.
  3018.  
  3019.  
  3020.     DATA INPUT RANGE
  3021.     ~~~~~~~~~~~~~~~~
  3022.     This powerful command is mainly for those who develop applications to
  3023.     be used by other individuals.  Once this option is invoked and a range
  3024.     is highlighted, cursor movement is restricted to the cells that were
  3025.     intentionally unprotected by the user using the /Range, Lock, No
  3026.     command.
  3027.  
  3028.     Example:
  3029.         /rlnC2..C4 [ENTER]          [Unlock Cells C2, C3, and C4]
  3030.         /sgpe                       [Turn On Protection]
  3031.         /dirA1..D8 [ENTER]          [Input Restricted Cells]
  3032.  
  3033.     would turn the global protection on and would only allow the user to
  3034.     move the cursor to cells C2, C3, and C4 (those specifically
  3035.     unprotected by the user).
  3036.  
  3037.  
  3038.     DATA INPUT FORM
  3039.     ~~~~~~~~~~~~~~~
  3040.     This powerful command allows a user to define a form that can be used for
  3041.     entering records, editing records, etc.  To create an input form:
  3042.  
  3043.     1.  Define a number of cells (in the same row) that contain the field
  3044.         headings for your database.
  3045.     2.  Format the field headings for the type of data each cell will
  3046.         contain/display.
  3047.     3.  Select Data Input Form, and highlight the range of field headings.
  3048.  
  3049.     AS-EASY-AS automatically takes the format of each field name cell and
  3050.     assigns it to new data input into that particular field.  It then
  3051.     creates an input/edit form, and locates the data base pointer at the
  3052.     first record of the database.  The user now has the option to enter a
  3053.     new record, edit the current record, move to the record ahead or
  3054.     before the current one, etc.
  3055.  
  3056.     NOTES:
  3057.       1.  All field names are left justified.  If the field names are to be
  3058.           right justified, they have to be padded with spaces.
  3059.       2.  A maximum of 15 input fields are supported.
  3060.       3.  The width of the column is used to set the data input field
  3061.           size.
  3062.  
  3063.  
  3064.  
  3065.  
  3066.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [52] 
  3067.       Example:
  3068.         Cells A2 through D2 contain the desired field names of an address
  3069.         database (First, last, Address, etc.)
  3070.  
  3071.     The keystrokes /difA2..D2[ENTER] will produce an AS-EASY-AS dtabase
  3072.     input form screen .
  3073.  
  3074.     To prepare the database to display the input data properly, the field
  3075.     names must first be formatted.  Since Name and Address will contain
  3076.     text, format these field names as "Label" (/Range Format Label).  This
  3077.     ensures that when a street number is entered, followed by the street
  3078.     name, the contents will be a label, rather than a value.
  3079.  
  3080.     Phone could also be formatted as "Label" in which case the user would
  3081.     need to provide the parenthesis and hyphen each time a phone number is
  3082.     entered.
  3083.  
  3084.     Format last call as date (/rfd) and select one of the date options.
  3085.     When entering the date, simply type "8/29/91".  AS-EASY-AS will
  3086.     convert the string to its date equivalent.
  3087.  
  3088.     If cell D2 had not been formatted with a date format, and the number
  3089.     was entered as 08/29/91 (no apostrophe), cell D3 would display
  3090.     0.0030315, i.e., the indicated division would have been performed; an
  3091.     action which was not intended.
  3092.  
  3093.     Note the description of the keys available in this mode displayed on
  3094.     the top line of the screen:
  3095.  
  3096.         PgUp          -  Go to the previous record
  3097.         PgDn          -  Go to the next record
  3098.         Ctrl-PgUp     -  Go to the beginning of the database (record #1)
  3099.         Ctrl-PgDn     -  Go to the end of the database
  3100.  
  3101.     The user can freely move up and down the fields using the arrow cursor
  3102.     keys.
  3103.  
  3104.  
  3105.  
  3106.  
  3107.  
  3108.  
  3109.  
  3110.  
  3111.  
  3112.  
  3113.  
  3114.  
  3115.  
  3116.  
  3117.  
  3118.  
  3119.  
  3120.  
  3121.  
  3122.  
  3123.  
  3124.  
  3125.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [53] 
  3126.     7. DATABASE OPERATIONS
  3127.     ~~~~~~~~~~~~~~~~~~~~~~
  3128.     A database is information stored in a range of one or more rows and
  3129.     columns.  The information that can be stored in a database is almost
  3130.     anything that one normally keeps track of.
  3131.  
  3132.     Let's see how you might use database commands to keep track of a list
  3133.     of your customers, their addresses and telephone numbers (a function
  3134.     that is normally performed by a stack of index cards or a Rolodex).
  3135.  
  3136.     A spreadsheet, for example, holds a small database of customers.
  3137.     The database of customers is stored in the range A1..G7.  For each
  3138.     customer, you intend to keep track of the first and last name, street
  3139.     address, city, state and telephone number.  Each row (all the
  3140.     information for one customer) is called a record of the database.
  3141.  
  3142.     Each column has a heading identifying the information stored in the
  3143.     cells beneath it.  Each heading is called a "field" of the record.
  3144.  
  3145.     Once the information is stored in this database format, you can look
  3146.     at it many different ways and gain valuable information from it using
  3147.     the AS-EASY-AS database commands.
  3148.  
  3149.     There are three ranges in the Database Menu which must be defined. The
  3150.     INPUT range, the CRITERION range and the OUTPUT range.
  3151.  
  3152.     The operations that can be performed, based on the above ranges, are:
  3153.  
  3154.       FIND - Highlight records that match the criterion range.
  3155.  
  3156.       EXTRACT - Copy records that meet the criterion range into the
  3157.                 output range.
  3158.  
  3159.  
  3160.     INPUT RANGE
  3161.     ~~~~~~~~~~~
  3162.     The input range is the entire area where the database information is
  3163.     stored. When the input range is specified, you must include the
  3164.     headings as the top row of the range.
  3165.  
  3166.     In the preceding example the input range would be A1..G7.  Notice that
  3167.     the range also contains the headings F. NAME, L. NAME, etc.
  3168.  
  3169.  
  3170.     CRITERION RANGE
  3171.     ~~~~~~~~~~~~~~~
  3172.     The criterion range contains the criteria that will be used to perform
  3173.     the FIND or EXTRACT operations on the Input range of the database.
  3174.     The minimum number of rows that can be used to define the criterion
  3175.     range is two.
  3176.  
  3177.     The top row ALWAYS contains the field headings exactly as they appear
  3178.     in the database.  It is good practice to copy these headings from the
  3179.     database itself to assure that they are exactly the same.  Subsequent
  3180.     rows contain the actual criteria.  Criteria fall into two categories,
  3181.     character comparisons and numeric comparisons.
  3182.  
  3183.  
  3184.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [54] 
  3185.     Character comparisons can be performed by looking for an exact match
  3186.     or by using wildcard characters.
  3187.  
  3188.     ?   Substitutes for any single character in the comparison string.
  3189.  
  3190.     *   Will match all characters to the right of the asterisk position.
  3191.  
  3192.     ... Ellipsis (3 dots) preceding a string will search each record for the
  3193.         occurrence of that string anywhere within the string.
  3194.  
  3195.     Numeric comparisons can be performed by using all of the logical
  3196.     operators defined in the Logical Operators section.
  3197.  
  3198.     Criteria placed in adjacent columns are treated as logical ANDs, while
  3199.     criteria placed in adjacent rows are treated as logical ORs.
  3200.  
  3201.     AS-EASY-AS provides you with the option to facilitate the inputting of
  3202.     criteria.  The command / Data Input Criteria operates similar to /
  3203.     Data Input Form described earlier. After the criteria range is
  3204.     selected, a criteria input form will appear in the middle of the
  3205.     screen.  The user can then enter the criteria for each field heading.
  3206.     If multiple matches for the same heading are desired, AS-EASY-AS will
  3207.     generate a second form once the first form has been completed.  An
  3208.     example of Data Input Criteria is shown in the database example.
  3209.  
  3210.     Although this might sound complicated, an example later on will
  3211.     demonstrate how all these rules work.
  3212.  
  3213.  
  3214.     OUTPUT RANGE
  3215.     ~~~~~~~~~~~~
  3216.     The EXTRACT command causes records that match the criteria to be
  3217.     placed in the output range.  The output range should contain the
  3218.     headings of the fields from which information is to be extracted.
  3219.  
  3220.  
  3221.     RESET
  3222.     ~~~~~
  3223.     The RESET command resets the data input, output and criteria ranges.
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.  
  3239.  
  3240.  
  3241.  
  3242.  
  3243.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [55] 
  3244.     8.  MATRIX OPERATIONS
  3245.     ~~~~~~~~~~~~~~~~~~~~~
  3246.     Matrix is a notation that is commonly used in the field of mathematics
  3247.     to describe a table of numbers.  When dealing with matrices you should
  3248.     be familiar with basic terminology and rules for matrix manipulation.
  3249.  
  3250.     A matrix is an array of values with a number of rows (i) and a number
  3251.     of columns (j). Mathematically, a matrix is denoted by an uppercase
  3252.     letter enclosed in brackets.
  3253.  
  3254.         [A]  -  Matrix A
  3255.  
  3256.     The elements of the matrix are denoted by the equivalent lowercase
  3257.     letter and two subscripts referring to the position of the element
  3258.     (row, column).
  3259.  
  3260.         a1,2  - the element of matrix [A] located in the first row and the
  3261.                 second column
  3262.  
  3263.     The transposition of a matrix [A] with size i,j (i-rows, j-columns) is
  3264.     a new matrix  [A]T with size j,i  (j-rows, i-columns).  After the
  3265.     transposition, the first row of [A] becomes the first column of [A]T,
  3266.     the second row of [A] becomes the second column of [A]T, etc.
  3267.  
  3268.  
  3269.       Example:
  3270.  
  3271.         ORIGINAL MATRIX                   TRANSPOSED MATRIX
  3272.  
  3273.             1   6   8                           1   5   9
  3274.             5   7   3                           6   7   1
  3275.             9   1   4                           8   3   4
  3276.  
  3277.     In operations involving two matrices, [A] (i,j) and [B] (k,n), the
  3278.     following rules must be observed:
  3279.  
  3280.         1.  The matrices can be added or subtracted only if:  i=k and j=n
  3281.  
  3282.         2.  The matrices can be multiplied only if:  i=n  and  j=k
  3283.  
  3284.  
  3285.     The inverse of a matrix [A] is a second matrix [A]-1, such that:
  3286.  
  3287.             [A] x [A]-1 = Identity matrix
  3288.  
  3289.  
  3290.     The identity matrix is a special matrix whose elements are:
  3291.  
  3292.             ai,j = 1.0      for any i=j
  3293.             ai,j = 0.0      for any i<>j
  3294.  
  3295.     That is, 1s appear along the diagonal of the matrix and all other
  3296.     values are zero.
  3297.  
  3298.     A matrix can be inverted only if the number of columns and rows are
  3299.     equal. This is called a square matrix.
  3300.  
  3301.  
  3302.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [56] 
  3303.     AS-EASY-AS supports the following basic matrix operations:
  3304.  
  3305.        Addition, Subtraction, Multiplication, Inversion, Transposition
  3306.  
  3307.     In addition to those, the program has a built-in option for solving a
  3308.     set of simultaneous equations with an equal number of unknowns.  Note
  3309.     that prior to solving such a set of equations, the constants vector
  3310.     should be placed in the column immediatelly to the right of the
  3311.     coefficients matrix.
  3312.  
  3313.  
  3314.  
  3315.  
  3316.  
  3317.  
  3318.  
  3319.  
  3320.  
  3321.  
  3322.  
  3323.  
  3324.  
  3325.  
  3326.  
  3327.  
  3328.  
  3329.  
  3330.  
  3331.  
  3332.  
  3333.  
  3334.  
  3335.  
  3336.  
  3337.  
  3338.  
  3339.  
  3340.  
  3341.  
  3342.  
  3343.  
  3344.  
  3345.  
  3346.  
  3347.  
  3348.  
  3349.  
  3350.  
  3351.  
  3352.  
  3353.  
  3354.  
  3355.  
  3356.  
  3357.  
  3358.  
  3359.  
  3360.  
  3361.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [57] 
  3362.     9. FUNCTIONS
  3363.     ~~~~~~~~~~~~
  3364.     A function is denoted by an @ (at) character preceding a function
  3365.     keyword. The following functions act upon the argument (represented by
  3366.     'x') contained within the parentheses.  The argument may be a value or
  3367.     formula which refers to other cells within the spreadsheet.
  3368.  
  3369.  
  3370.     STRING FUNCTIONS
  3371.     ~~~~~~~~~~~~~~~~
  3372.     +Cell  (Where Cell contains a String)
  3373.     Syntax:  +Cell Address
  3374.        The addition sign has the same effect as when used with values. The
  3375.        above entry indicates that the current cell will always have the
  3376.        same contents as Cell, whether Cell contains a string or a value.
  3377.  
  3378.     & - Concatenation
  3379.        The ampersand (&) is used to add two string expressions together.
  3380.        Note that using the plus sign (+), when adding strings, would give
  3381.        erroneous results.
  3382.  
  3383.        Example: "Abc"&"D2N" will produce AbcD2N
  3384.  
  3385.     @@
  3386.     Syntax:  @@(Cell)
  3387.        The @@ function is used to indirectly address the location
  3388.        described by the string in Cell (another spreadsheet cell).
  3389.  
  3390.        Examples:
  3391.         Assume the following cell contents:
  3392.             Cell A1 contains the string "Sample"
  3393.             Cell A5 contains the string "A1"  (Note that it must be
  3394.             uppercase)
  3395.         @@(A5) = the contents of the cell described in A5 = Sample
  3396.  
  3397.        NOTE:  If the indirectly referenced cell changes, you must
  3398.               refresh the value with the F9 key or the {CALC} macro.
  3399.  
  3400.     @CELL
  3401.     Syntax:  @CELL("Type",Cell)
  3402.        Operates the same as @CELLPT, but returns information about the
  3403.        referenced Cell.  See @CELLPT for "Type" descriptions.
  3404.  
  3405.     @CELLPT
  3406.     Syntax:  @CELLPT("Type")
  3407.        Type =  One of the predefined words described below.  Type
  3408.                MUST be enclosed in double quotes (only the first three
  3409.                characters of the type are required).
  3410.  
  3411.        Returns information about the current cell (i.e., the cell where
  3412.        the cursor is currently located).  The information returned depends
  3413.        on the function argument, as described below.  The function will
  3414.        return a value or a string, depending on specific Type.
  3415.  
  3416.        NOTE: A cell containing an @CELLPT command will only be
  3417.              updated when the sheet is re-calculated either with [F9]
  3418.              or a {CALC} macro.
  3419.  
  3420.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [58] 
  3421.        Type = "FORm"  (String)
  3422.        Returns the format of the current cell (see Range Format for
  3423.        format descriptions).  The string returned is of the following:
  3424.  
  3425.        blank = Unformatted cell
  3426.        Sn =    Scientific with n decimals
  3427.        Fn =    Fixed with n decimals
  3428.        ,n =    Comma format with n decimals
  3429.        Cn =    Currency format with n decimals
  3430.        Dn =    Date format, type n (see date formats)
  3431.        %n =    Percent with n decimals
  3432.        + =     +/- format
  3433.        T =     Text format
  3434.        H =     Hidden format
  3435.        G =     General format
  3436.        bn=     Engineering format with n decimals
  3437.        L =     Label format
  3438.        X =     Box or line character format
  3439.  
  3440.        Type = "ADDress"  (String)
  3441.        Returns the address of the current cell, in the form of a string
  3442.       'ColumnRow'  (e.g.,  A1, C12, AF321).
  3443.  
  3444.        Type = "CONtents"  (String)
  3445.        Returns the physical contents of the current cell as a string.
  3446.        e.g., if the current cell contains +A1+1, the string "+A1+1" is
  3447.        returned.
  3448.  
  3449.        Type = "ROW"  (Value)
  3450.        Returns the row address of the current cell.
  3451.  
  3452.        Type = "COLumn"  (Value)
  3453.        Returns the column address of the current cell as a value,
  3454.        (e.g., A=1, B=2, C=3, etc.)
  3455.  
  3456.  
  3457.        Type = "WIDth"  (Value)
  3458.         Returns the column width of the current cell.
  3459.  
  3460.        Type = "TYPe"  (Value)
  3461.        Returns one of the following values depending on the contents of
  3462.        the current cell:
  3463.  
  3464.         0 - String Formula
  3465.         1 - Value Formula
  3466.         2 - Real/Value
  3467.         3 - Integer/Value
  3468.         4 - String/Label
  3469.         5 - Blank Cell
  3470.         6 - Virgin Blank cell
  3471.         8 - String formula error
  3472.         9 - Value formula error
  3473.  
  3474.        Type = "PREfix"  (Label)
  3475.        Returns the first character of the current cell's contents (',
  3476.        ", ^, +, -, i, @, P).  If the cell contains a value, the left-
  3477.        most digit will be returned. e.g., 456 will return the label 4.
  3478.  
  3479.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [59] 
  3480.     @CHR
  3481.     Syntax:  @CHR(Num)
  3482.         Num = a value, or calculated variable, between 0 and 255
  3483.         Returns the ASCII character corresponding to Num (fractional
  3484.         values are ignored).  Refer to Appendix E of the AS-EASY-AS manual
  3485.         for a table of the ASCII character codes.
  3486.  
  3487.         Examples:
  3488.             @CHR(36) = $
  3489.  
  3490.     @EXACT
  3491.     Syntax:  @EXACT(String1,String2)
  3492.         Compares String1 to String2 to see if an exact match exists. If
  3493.         the strings are equal, the function returns the value 1 (true),
  3494.         otherwise it returns the value 0 (false).  Please note that this
  3495.         function is case sensitive so characters in the two strings have
  3496.         to match exactly (e.g., A=A, A<>a).
  3497.  
  3498.         Examples:
  3499.             @EXACT("This is an Example","This Is An Example") = 0 (not
  3500.             equivalent strings as "an" is different from "An")
  3501.  
  3502.     @FIND
  3503.     Syntax:  @FIND(String1,String2,Start)
  3504.         Returns the position of String1 in String2; Search starts at
  3505.         position Start of String2 (first character is assigned an index of
  3506.         1).
  3507.  
  3508.         Examples:
  3509.            @FIND("hello","Dave says hello",1) returns the value 11
  3510.            @FIND("e","Dave says hello",1) returns the value 4
  3511.            @FIND("e","Dave says hello",5) returns the value 12
  3512.  
  3513.     @LEFT
  3514.     Syntax:  @LEFT(String,Num)
  3515.         String = Any string,
  3516.         Num = Numeric value or value formula
  3517.         Returns a substring starting with the first character of String,
  3518.         Num characters long.
  3519.  
  3520.  
  3521.         Examples:
  3522.           @LEFT("This is an example",6)  = This i
  3523.  
  3524.  
  3525.     @LENGTH
  3526.     Syntax:  @LENGTH(String)
  3527.         String = Any string
  3528.         Returns the number of characters in String.  Please note that
  3529.         spaces are also characters.  References to labels ignore the
  3530.         prefix character.
  3531.  
  3532.         Examples:
  3533.           @LENGTH("abcdefG") = 7
  3534.           @LENGTH("ABc"&"123") = 6
  3535.  
  3536.  
  3537.  
  3538.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [60] 
  3539.     @LOWER
  3540.     Syntax:  @LOWER(String)
  3541.         String = Any string
  3542.         Converts all characters in String to lower case.
  3543.  
  3544.         Examples:
  3545.           @LOWER("This is an Example") = this is an example
  3546.           @LOWER(@LEFT("This is an example",4)) = this
  3547.  
  3548.     @MID
  3549.     Syntax:  @MID(String,Start,Num)
  3550.         String = Any string
  3551.         Start, Num = Numeric values or value formulas
  3552.         Returns a substring from String Num characters long, starting at
  3553.         position Start (from the left).
  3554.  
  3555.         Examples:
  3556.           @MID("This is an example",2,3) = his
  3557.  
  3558.     @N
  3559.     Syntax:  @N(Cell)
  3560.         Similar to @S.  This function inspects Cell, and returns the value
  3561.         contained in it.  If the cell is blank, or contains a string, then
  3562.         the function returns zero.
  3563.  
  3564.         Examples:
  3565.            @N(C9) = 0 if C9 contains the string "Test"
  3566.            @N(B9) = 28 if B9 contains the value 28
  3567.  
  3568.     @ORD
  3569.     Syntax:  @ORD(String)
  3570.         String = Any string
  3571.         Returns the decimal ASCII code of first character of String.  All
  3572.         other characters in String are ignored.
  3573.  
  3574.  
  3575.         Examples:
  3576.            @ORD("215")     = 50
  3577.            @ORD("┴")       = 193
  3578.  
  3579.     @PROPER
  3580.     Syntax:  @PROPER(String)
  3581.         String = Any string
  3582.         Converts the first letter of each word in String to upper case,
  3583.         such as in a proper name.  Characters already in upper case are
  3584.         left unchanged.
  3585.  
  3586.         Examples:
  3587.            @PROPER("This example") = This Example
  3588.  
  3589.     @REPEAT
  3590.     Syntax:  @REPEAT(String,Num)
  3591.         String = Any string,
  3592.         Num = Any number or value formula
  3593.         Repeats the string argument Num times.
  3594.  
  3595.  
  3596.  
  3597.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [61] 
  3598.         Examples:
  3599.            @REPEAT("Sample",3) = SampleSampleSample
  3600.            @REPEAT("This"&" Sample",2) = This SampleThis Sample
  3601.  
  3602.     @RIGHT
  3603.     Syntax:  @RIGHT(String,Num)
  3604.         String = Any string
  3605.         Num = Numeric value or value formula
  3606.         Similar to @MID and @LEFT, this function returns a substring, Num
  3607.         characters long, starting from the right of String.
  3608.  
  3609.         Examples:
  3610.            @RIGHT("This Example",6) = xample
  3611.            @RIGHT(@MID("Example",2,3),2) = am
  3612.  
  3613.     @S
  3614.     Syntax:  @S(Cell)
  3615.         This function inspects Cell, and returns the string contained in
  3616.         it.  If the cell is blank, or contains a numeric value, a null
  3617.         string is returned.
  3618.  
  3619.         @S acts as a filter and will only return a string reference.  It
  3620.         may be used in cases where a referenced cell may contain either a
  3621.         value or a string, without generating an error condition.
  3622.  
  3623.         Examples:
  3624.            @S(C9) = "Test" if C9 contains the string "Test"
  3625.            @S(B9) = Null string if B9 contains the value 28
  3626.  
  3627.     @STR
  3628.     Syntax:  @STR(Value,Num)
  3629.         Value = Any value or calculated variable
  3630.         Num = Number of decimal digits to retain
  3631.         Returns a string made up of Value with Num digits after the decimal.
  3632.  
  3633.         Example:
  3634.            @STR(1234.12345,3) = "1234.123"
  3635.  
  3636.     @TRIM
  3637.     Syntax:  @TRIM(String)
  3638.         String = Any string
  3639.         Trims multiple blank spaces from String and replaces each
  3640.         occurrence with a single space character.  The effect is evident
  3641.         when such strings are used in subsequent string operations.
  3642.  
  3643.         Example:
  3644.         @TRIM("  This is      an    example  ") = This is an example
  3645.  
  3646.     @UPPER
  3647.     Syntax:  @UPPER(String)
  3648.         String = Any string
  3649.         Converts all characters of String to upper case.  Numbers and
  3650.         special characters remain unchanged.
  3651.  
  3652.         Examples:
  3653.            @UPPER("Example") = EXAMPLE
  3654.            @UPPER(@LEFT("+example$",9)) = +EXAMPLE$
  3655.  
  3656.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [62] 
  3657.     @VAL
  3658.     Syntax:  @VAL(String)
  3659.         String = Any string
  3660.         Converts String into a numeric value.  String may also be a string
  3661.         function, but you cannot embed value formulas in the String. If a
  3662.         value formula is embedded, then the value of zero is returned.
  3663.  
  3664.         Note that this function will accept the decimal separator
  3665.         specified with the User, Install, Punctuation command.  The
  3666.         examples below assume that "." is the decimal separator.
  3667.  
  3668.         Examples:
  3669.            @VAL("123")     = 123
  3670.            @VAL("1.23")    = 1.23
  3671.            @VAL("4/2")     = 0
  3672.            @VAL("2..34")   = 0
  3673.  
  3674.  
  3675.  
  3676.  
  3677.  
  3678.  
  3679.  
  3680.  
  3681.  
  3682.  
  3683.  
  3684.  
  3685.  
  3686.  
  3687.  
  3688.  
  3689.  
  3690.  
  3691.  
  3692.  
  3693.  
  3694.  
  3695.  
  3696.  
  3697.  
  3698.  
  3699.  
  3700.  
  3701.  
  3702.  
  3703.  
  3704.  
  3705.  
  3706.  
  3707.  
  3708.  
  3709.  
  3710.  
  3711.  
  3712.  
  3713.  
  3714.  
  3715.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [63] 
  3716.     MATH FUNCTIONS
  3717.     ~~~~~~~~~~~~~~
  3718.     NOTES:
  3719.     1. The arguments for all trigonometric functions must be in radians.
  3720.  
  3721.     2. The arguments for all hyperbolic functions must be in
  3722.        hyperbolic radians.
  3723.  
  3724.     3. An out of range argument will result in ERR being
  3725.        displayed.
  3726.  
  3727.     @ABS
  3728.     Syntax:  @ABS(x)
  3729.         x = any value
  3730.         Returns the absolute value of the argument.
  3731.  
  3732.         Examples:
  3733.           @ABS(-10)  = 10
  3734.           @ABS(5)    =  5
  3735.  
  3736.  
  3737.     @ACOS
  3738.     Syntax:  @ACOS(x)
  3739.         x = any value where -1 < x < 1
  3740.         Arc cosine of value, returns radians.
  3741.  
  3742.  
  3743.     @ACOSH
  3744.     Syntax:     @ACOSH(x)
  3745.         x = any value where x > 1
  3746.         Arc hyperbolic cosine of value x, returns radians.
  3747.  
  3748.  
  3749.     @ASIN
  3750.     Syntax:  @ASIN(x)
  3751.         x = any value where -1 < x < 1
  3752.         Arc sine of value x, returns radians.
  3753.  
  3754.  
  3755.     @ASINH
  3756.     Syntax:     @ASINH(x)
  3757.         x = any value
  3758.         Arc hyperbolic sine of value x, returns radians.
  3759.  
  3760.     @ATAN
  3761.     Syntax:  @ATAN(x)
  3762.         x = any value
  3763.         Arc tangent of value, returns radians.
  3764.  
  3765.  
  3766.     @ATANH
  3767.     Syntax:  @ATANH(x)
  3768.         x = any value where -1 < x < 1
  3769.         Arc hyperbolic tangent of value x, returns radians.
  3770.  
  3771.  
  3772.  
  3773.  
  3774.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [64] 
  3775.     @COS
  3776.     Syntax:  @COS(x)
  3777.         x = any value in radians
  3778.         Cosine of angle x in radians.
  3779.  
  3780.  
  3781.     @COSH
  3782.     Syntax:  @COSH(x)
  3783.         x = any value in radians where -88 < x < 88
  3784.         Hyperbolic cosine of angle x in radians
  3785.  
  3786.  
  3787.     @CSC
  3788.     Syntax:     @CSC(x)
  3789.         x = any value in radians where x <> 0, π
  3790.         Cosecant of angle x in radians.
  3791.  
  3792.  
  3793.     @CTN
  3794.     Syntax:  @CTN(x)
  3795.         x = any non-zero value where x <> 0, π
  3796.         Cotangent of value
  3797.  
  3798.     @EXP
  3799.     Syntax:  @EXP(x)
  3800.         x = any value where -88 < x < +88
  3801.         Exponential of x (raise 'e' to the 'x' power).
  3802.  
  3803.  
  3804.     @FALSE
  3805.     Constant which has a value of 0.
  3806.  
  3807.  
  3808.     @GAMMALN
  3809.     Syntax:  @GAMMALN(x)
  3810.         x = any positive value
  3811.         Returns the natural logarithm  of the Gamma function for the value
  3812.         x. The Gammaln function is the floating point equivalent of the
  3813.         factorial function, and is related by:
  3814.  
  3815.                      (N-1)! = @EXP(@GAMMALN(N))
  3816.  
  3817.         Example:
  3818.             @GAMMALN(6.5) = 5.662562
  3819.  
  3820.  
  3821.     @INT
  3822.     Syntax= @INT(x)
  3823.         x = any value
  3824.         Integer value of argument.  The fractional part of the number is
  3825.         truncated and the integer remainder is returned.  (See also
  3826.         command line switch /RA)
  3827.  
  3828.         Examples:
  3829.           @INT(10.60) = 10
  3830.           @INT(0.156) =  0
  3831.  
  3832.  
  3833.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [65] 
  3834.     @LOG
  3835.     Syntax:  @LOG(x)
  3836.         x = any value where x > 0
  3837.         Returns the logarithm to base '10' of the argument.
  3838.  
  3839.  
  3840.     @LN
  3841.     Syntax:  @LN(x)
  3842.         x = any value where x > 0
  3843.         Returns the natural Logarithm (base 'e') of the argument.
  3844.  
  3845.         Example:
  3846.            @LN(6)= 1.7917594692
  3847.  
  3848.  
  3849.     @MOD(x,y)
  3850.     x = any value
  3851.     y = any non-zero value
  3852.         Modulo division, returns the remainder of x divided by y.
  3853.  
  3854.             @MOD(10,3) = 1
  3855.             @MOD(8,2)  = 0
  3856.  
  3857.  
  3858.     @NA
  3859.     Constant which has a value of -1.
  3860.  
  3861.  
  3862.     @PI
  3863.     Constant which has a value of 3.1415926536
  3864.  
  3865.  
  3866.     @RAND
  3867.     Returns a new random number with each recalculation.
  3868.  
  3869.  
  3870.     @ROUND(x,y)
  3871.     x = any value
  3872.     y = any integer value where -11 < y < 11
  3873.  
  3874.         Rounds the value of x to y digits right of the decimal.  Negative
  3875.         numbers round to left of decimal.
  3876.  
  3877.             @ROUND(10.1234,1) = 10.1
  3878.             @ROUND(123.123,-2)= 100
  3879.  
  3880.  
  3881.     @SEC
  3882.     Syntax:     @SEC(x)
  3883.         x = any angle in radians where x <> pi/2, -pi/2
  3884.         Secant of angle x in radians.
  3885.  
  3886.  
  3887.     @SIN
  3888.     Syntax: @SIN(x)
  3889.         x = any value in radians
  3890.         Sine of angle x in radians.
  3891.  
  3892.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [66] 
  3893.     @SINH
  3894.     Syntax:     @SINH(x)
  3895.         x = any value in radians where -88 < x < +88
  3896.         Hyperbolic sine of angle x in radians
  3897.  
  3898.     @SQRT(x)
  3899.     x = any value where x ≥ 0
  3900.         Returns the square root of argument, (a negative argument will
  3901.         result in an error).
  3902.  
  3903.             @SQRT(2) =  1.4142135624
  3904.             @SQRT(36) = 6
  3905.  
  3906.  
  3907.     @TAN
  3908.     Syntax:     @TAN(x)
  3909.         x = any value in radians where  x <> π/2, -π/2
  3910.         Tangent of angle x in radians
  3911.  
  3912.  
  3913.     @TANH
  3914.     Syntax:     @TANH(x)
  3915.         x = any value in radians where -88 < x < +88
  3916.         Hyperbolic tangent of angle x in radians
  3917.  
  3918.  
  3919.     @TRUE
  3920.     Constant has a value of  1.
  3921.  
  3922.  
  3923.     FINANCIAL FUNCTIONS
  3924.     ~~~~~~~~~~~~~~~~~~~
  3925.  
  3926.     NOTES:
  3927.  
  3928.     1. For financial functions, all interest rates must be expressed
  3929.        in decimal fractions, or followed by the % operator.  For
  3930.        example, 0.08 = 8%.
  3931.  
  3932.     2. The interest rate must be in the same units as the payment
  3933.        period.  If a monthly payment is desired, the interest rate
  3934.        must be expressed as a monthly rate (equal to the annual
  3935.        rate divided by 12).
  3936.  
  3937.  
  3938.     @CTERM
  3939.     Syntax:  @CTERM(Int,FVal,PVal)
  3940.         FVal    = Future Value
  3941.         Pval    = Present Value
  3942.         Int     = Interest Rate per compounding period
  3943.  
  3944.         Returns the number of compounding periods required for a present
  3945.         value (PVal), invested at an interest rate (Int) per compounding
  3946.         period to reach a future value (FVal).
  3947.  
  3948.  
  3949.  
  3950.  
  3951.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [67] 
  3952.         Examples:
  3953.            @CTERM(0.1,100000,10000)        =  24.2
  3954.            @CTERM(0.08,400000,60000)       =  24.7
  3955.  
  3956.  
  3957.     @DDB
  3958.     Syntax:  @DDB(Cost,Salvage,Life,Period)
  3959.         Cost        =  Cost of a purchase
  3960.         Salvage     =  Value at the end of the depreciation
  3961.         Life        =  Number of periods for full depreciation
  3962.         Period      =  Current Period
  3963.  
  3964.         Returns the amount of depreciation allowed during the specified
  3965.         period, using the Double-Declining-Balance depreciation method.
  3966.  
  3967.         Example:  5-Year Depreciation Schedule
  3968.           @DDB(5000,1000,5,1)     =   2000.0
  3969.           @DDB(5000,1000,5,2)     =   1200.0
  3970.           @DDB(5000,1000,5,3)     =    720.0
  3971.           @DDB(5000,1000,5,4)     =     80.0
  3972.           @DDB(5000,1000,5,5)     =      0.0
  3973.           To Date Total               4000.0
  3974.  
  3975.  
  3976.     @FV
  3977.     Syntax:  @FV(Annuity,Interest Rate,Period)
  3978.         Annuity     =  Periodic payment amount
  3979.         Interest    =  Periodic interest rate
  3980.         Period      =  Number of periods
  3981.  
  3982.         Returns the future value corresponding to an annuity occurring
  3983.         over the specified period.
  3984.  
  3985.         Example:
  3986.            @FV(700,0.0925,30) = 99979.77
  3987.  
  3988.     @IRR
  3989.     Syntax:  @IRR(Guesstimate Interest Rate,Range)
  3990.         Guesstimate Interest Rate =     Best guess at internal rate of return
  3991.                                         periodic interest rate
  3992.         Range =                         Cell range which contains the cash
  3993.                                         flow return values
  3994.  
  3995.         Returns the Rate of Return per period associated with a cash flow.
  3996.         The solution is iterative and may result in more than one correct
  3997.         answer, so a good guess is important.
  3998.  
  3999.         Example:
  4000.  
  4001.                A1      B1      C1      D1
  4002.             -1000      300     400     500
  4003.  
  4004.             @IRR(0.1,A1..D1) = 0.088963, or 8.9%
  4005.  
  4006.  
  4007.  
  4008.  
  4009.  
  4010.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [68] 
  4011.     @NPV
  4012.     Syntax:  @NPV(Interest Rate,Range)
  4013.         Interest Rate   =   Periodic interest rate
  4014.         Range           =   Cell range which in which the series of cash
  4015.                             flows is to be stored
  4016.  
  4017.         Returns the net present value of a cash flow over interest period.
  4018.  
  4019.         Example:
  4020.            @NPV(0.0925,A1..A5)
  4021.  
  4022.  
  4023.     @PMT
  4024.     Syntax:  @PMT(Principal,Interest Rate,Period)
  4025.         Principal       =   Principal amount
  4026.         Interest Rate   =   Periodic interest rate
  4027.         Period          =   Number of periods
  4028.  
  4029.         Returns the amount of an annuity equal to the principal amortized
  4030.         over the period.
  4031.  
  4032.         Example:
  4033.            @PMT(75000,0.0925,30) = 7462.606
  4034.  
  4035.  
  4036.     @PV
  4037.     Syntax:  @PV(Annuity,Interest Rate,Period)
  4038.         Annuity     =   Periodic payment amount
  4039.         Interest    =   Periodic interest rate
  4040.         Period      =   Number of periods
  4041.  
  4042.         Returns the present value corresponding to an annuity occurring
  4043.         over the specified period.
  4044.  
  4045.         Example:
  4046.            @PV(700,0.0925,30) = 7035.075
  4047.  
  4048.  
  4049.     @RATE
  4050.     Syntax:  @RATE(Fval,PVal,Nterm)
  4051.  
  4052.         FVal        =   Future value
  4053.         PVal        =   Present value
  4054.         NTerm       =   Number of compounding terms
  4055.  
  4056.         Returns the interest rate required for a present value PVal,
  4057.         invested for Nterm number of compounding periods to reach a future
  4058.         value FVal.
  4059.  
  4060.         Examples:
  4061.            @RATE(90000,20000,20)  =       0.078
  4062.            @RATE(190000,50000,20) =       0.069
  4063.  
  4064.  
  4065.  
  4066.  
  4067.  
  4068.  
  4069.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [69] 
  4070.     @SLN
  4071.     Syntax:  @SLN(Cost,Salvage,Life)
  4072.         Cost        =   Cost of a purchase
  4073.         Salvage     =   Value at the end of the depreciation
  4074.         Life        =   Number of periods for full depreciation
  4075.  
  4076.         Returns the amount of depreciation per period, using the straight
  4077.         line depreciation method.
  4078.  
  4079.         Examples:
  4080.            @SLN(5000,1000,5)       =    800.0
  4081.            @SLN(11000,1600,10)     =    940.0
  4082.  
  4083.  
  4084.     @SYD
  4085.     Syntax:  @SYD(Cost,Salvage,Life,Period)
  4086.         Cost    =  Cost of a purchase
  4087.         Salvage =  Value at the end of the depreciation
  4088.         Life    =  Number of periods for full depreciation
  4089.         Period  =  Current Period
  4090.  
  4091.         Returns the amount of depreciation allowed during the specified
  4092.         period, using the Sum-of-Years depreciation method.
  4093.  
  4094.         Example:  5-Year Depreciation Schedule
  4095.            @SYD(5000,1000,5,1)     =   1333.3
  4096.            @SYD(5000,1000,5,2)     =   1066.7
  4097.            @SYD(5000,1000,5,3)     =    800.0
  4098.            @SYD(5000,1000,5,4)     =    533.3
  4099.            @SYD(5000,1000,5,5)     =    266.7
  4100.                To Date Total           4000.0
  4101.  
  4102.  
  4103.     @TERM
  4104.     Syntax:  @TERM(Pmt,Int,FVal)
  4105.         FVal    = Future value
  4106.         Pmt     = Periodic payment
  4107.         Int     = Interest rate per compounding period
  4108.  
  4109.         Returns the number of compounding periods required for some
  4110.         periodic payment (Pmt), invested at an interest rate (Int) per
  4111.         compounding period to reach a future value (FVal).
  4112.  
  4113.         Examples:
  4114.           @TERM(100,0.15,1000)        =      6.6 periods
  4115.           @TERM(850,0.07,100000)      =     32.9 periods
  4116.  
  4117.  
  4118.  
  4119.  
  4120.  
  4121.  
  4122.  
  4123.  
  4124.  
  4125.  
  4126.  
  4127.  
  4128.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [70] 
  4129.     LOGICAL FUNCTIONS
  4130.     ~~~~~~~~~~~~~~~~~
  4131.     #OR# & #AND# Operators
  4132.  
  4133.     The #OR# & #AND# logical operators are used to combine simple logical
  4134.     criteria into complex logical expressions.  These two operators are
  4135.     evaluated according to the following logical table:
  4136.  
  4137.         ==============================================
  4138.             Test1      Test2       #OR#       #AND#
  4139.         ===============================================
  4140.             True       True       True        True
  4141.             True       False      True        False
  4142.             False      True       True        False
  4143.             False      False      False       False
  4144.         ==============================================
  4145.  
  4146.     Examples:
  4147.                        Expression               Result
  4148.                     ~~~~~~~~~~~~~~~~        ~~~~~~~~~~~~~~~~
  4149.                     +(0=0)#AND#(0=1)            0    (False)
  4150.                     +(0=0)#OR#(0=1)             1    (True)
  4151.  
  4152.     @IF(@MOD(5,2)=1#AND#@MOD(6,2)=0,1,0) returns 1 (true)
  4153.  
  4154.     NOTES:      1.  Spaces between the values and logical operators are
  4155.                     not allowed.
  4156.                 2.  Use of parentheses is recommended for clarity.
  4157.  
  4158.  
  4159.     @IF
  4160.     Syntax:  @IF(Test argument,arg1,arg2)
  4161.         If the test is true, Arg1 is returned, otherwise Arg2 is returned.
  4162.         TEST can utilize logical operators '>,<,=,<>' etc., or refer to
  4163.         the result of a cell with a logical result in it.
  4164.  
  4165.         Examples:
  4166.           @IF(10>2,3*2,4+5) = 6
  4167.           @IF(10<2,3*2,4+5) = 9
  4168.  
  4169.         As an example of using a logical operation within a formula try
  4170.         the following:
  4171.  
  4172.         +(a1>2)*3+(a1<=2)*4
  4173.  
  4174.         This formula will yield a result of 3 if the value stored in cell
  4175.         A1 is greater than 2 and will yield a result of 4 if the value is
  4176.         less than 2.
  4177.  
  4178.         NOTE:  Up to 10 nested @IF statements are allowed providing
  4179.                internal limit of 240 bytes per formula is not exceeded.
  4180.  
  4181.  
  4182.     @ISNUM
  4183.     Syntax:  @ISNUM(Cell)
  4184.         This function is similar to the @ISSTR function.  It will return 1
  4185.         for TRUE if the cell contains a number or a formula, 0 for FALSE.
  4186.  
  4187.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [71] 
  4188.     @ISSTR
  4189.     Syntax:  @ISSTR(Cell)
  4190.         This function checks to see if the specified cell contains a
  4191.         label. It returns 1 for TRUE if the cell contains a string or a
  4192.         label, 0 for FALSE.
  4193.  
  4194.         NOTE:  A blank cell is neither a string nor a number.
  4195.  
  4196.  
  4197.     @ISNA
  4198.     Syntax:  @ISNA(Cell)
  4199.         Tests for the special value of NA in cell.  If the cell contains
  4200.         NA it returns 1 (true); otherwise, it returns 0 (false).  Please
  4201.         note that if a cell contains the label "NA" (not produced by the
  4202.         @NA function), it is not recognized by the @ISNA function.
  4203.  
  4204.  
  4205.     @ISERR
  4206.     Syntax:  @ISERR(Expression)
  4207.              where expression can be a cell reference or any other valid AS-
  4208.              EASY-AS expression.
  4209.  
  4210.         This function is used to trap ERR displays and prevent propagation
  4211.         through the recalculation sequence.  A value of 1 (true) is
  4212.         returned if the cell contains ERR or the expression evaluates to
  4213.         an error condition.  A value of 0 (false) is returned otherwise.
  4214.  
  4215.         Examples:
  4216.            @ISERR(10/5)=0  (Not an error)
  4217.            @ISERR(10/0)=1  (Error in Expression)
  4218.  
  4219.  
  4220.     @ERR
  4221.     Syntax:  @ERR
  4222.         Returns the value ERR in the current cell and in any other cells
  4223.         that reference it directly or indirectly. The ERR value returned
  4224.         by this function is the same ERR value produced by AS-EASY-AS when
  4225.         it encounters an error.
  4226.  
  4227.  
  4228.     @NOT
  4229.     Syntax:  @NOT(Cell)
  4230.         Returns the value 0 if cell contains the value 1 and the value 1
  4231.         if cell contains 0 or any other value.  If cell contains a string,
  4232.         then the string is returned, unchanged.
  4233.  
  4234.  
  4235.  
  4236.  
  4237.  
  4238.  
  4239.  
  4240.  
  4241.  
  4242.  
  4243.  
  4244.  
  4245.  
  4246.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [72] 
  4247.  
  4248.     STATISTICAL FUNCTIONS
  4249.     ~~~~~~~~~~~~~~~~~~~~~
  4250.     These functions operate on a range of values. A range specifies a
  4251.     rectangular block of data in the spreadsheet, i.e.  Range = A1..B10
  4252.     defines the block of data from:
  4253.  
  4254.                               a1...b1
  4255.                                .    .
  4256.                                .    .
  4257.                              a10...b10
  4258.  
  4259.  
  4260.     Presented below are the statistical functions.  To illustrate the use
  4261.     of each function, simple examples are provided.
  4262.  
  4263.     All examples will operate on the numbers contained in the portion of
  4264.     the spreadsheet duplicated below, A1..C3
  4265.  
  4266.           ........A/.......B/.......C/
  4267.         1       1.1      5.6      8.2
  4268.         2       2.3      7.5       10
  4269.         3       3.5      4.4        2
  4270.  
  4271.  
  4272.     @AVG
  4273.     Syntax:  @AVG(Range)
  4274.         Range =     Cell range to be averaged
  4275.         Returns the average of the range.
  4276.  
  4277.         Example:
  4278.            @AVG(A1..C3) = 4.955555
  4279.  
  4280.  
  4281.     @COMB
  4282.     Syntax:  @COMB(N,R)
  4283.         N,R = any integer value such that N ≥ R
  4284.  
  4285.         Number of combinations of N distinct items taken R at a time.
  4286.  
  4287.         Example:    @COMB(6,2) = 30
  4288.  
  4289.  
  4290.     @COUNT
  4291.     Syntax:  @COUNT(Range)
  4292.         Range =     Cell range to be counted
  4293.         Returns the number of elements in the range, (blank cells and
  4294.         cells containing text are ignored).
  4295.  
  4296.         Example:
  4297.            @COUNT(A1..C3) = 9
  4298.  
  4299.  
  4300.  
  4301.  
  4302.  
  4303.  
  4304.  
  4305.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [73] 
  4306.     @FACT
  4307.     Syntax:  @FACT(X)
  4308.         X = Numeric value where (0 < X < 33)
  4309.         Returns the factorial of X.  (See also @GAMMALN for floating point
  4310.         related function and "!" operator).
  4311.  
  4312.         Example:
  4313.           @FACT(6) = 720
  4314.  
  4315.  
  4316.     @MAX
  4317.     Syntax:  @MAX(Range)
  4318.         Range =     Cell range to be analyzed
  4319.         Returns the maximum value in the range.
  4320.  
  4321.         Examples:
  4322.           @MAX(A1..C3) = 10
  4323.           @MAX(A1..A3,15,C1..C3) = 15
  4324.  
  4325.  
  4326.     @MIN
  4327.     Syntax:  @MIN(Range)
  4328.         Range =     Cell range to be analyzed
  4329.         Returns the minimum value in the range.
  4330.  
  4331.         Examples:
  4332.           @MIN(A1..C3) = 1.1
  4333.           @MIN(A1..A3,1,C1..C3) = 1
  4334.  
  4335.  
  4336.     @PERM
  4337.         Syntax:  @PERM(N,R)
  4338.         N,R = any integer value such that N ≥ R
  4339.         Number of permutations of N distinct items taken R at a time.
  4340.  
  4341.         Example:    @PERM(6,2) = 15
  4342.  
  4343.  
  4344.  
  4345.  
  4346.     SPECIAL NOTES
  4347.     ~~~~~~~~~~~~~
  4348.         1.  The following .... functions require the criterion  be a string
  4349.             argument.  References to string arguments are permitted.
  4350.  
  4351.         2.  @X represents reference to cell in range upon which
  4352.             criterion is applied (required).
  4353.  
  4354.  
  4355.     @QMAX
  4356.     Syntax:  @QMAX("@X=Criterion",Range,Offset)
  4357.         Criterion = Value or formula to be used for match
  4358.         Range = Cell range
  4359.         Offset = Number of columns to the right/left on which to operate.
  4360.  
  4361.         Returns the maximum value of those cells in the range that match
  4362.         the criterion.
  4363.  
  4364.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [74] 
  4365.         Example:   @QMAX("@X<2.5",A1..A3,1) = 7.5
  4366.                    @QMAX("@X<2.5",A1..A3,0) = 2.3
  4367.  
  4368.  
  4369.     @QMIN
  4370.     Syntax:  @QMIN("@X=Criterion",Range, Offset)
  4371.         Criterion = Value or formula to be used for match
  4372.         Range = Cell range
  4373.         Offset = Number of columns to the right/left on which to operate.
  4374.         Returns the minimum value of those cells in the range that match
  4375.         the criterion.
  4376.  
  4377.         Example:  @QMIN("@X>2.0",A1..A3,1) = 4.4
  4378.  
  4379.  
  4380.     @QSTD
  4381.     Syntax:  @QSTD("@X=Criterion",Range,Offset)
  4382.         Criterion = Value or formula to be used for match
  4383.         Range = Cell range
  4384.         Offset = Number of columns to the right/left on which to operate.
  4385.         Returns the standard deviation of those cells records in the range
  4386.         that match the criterion.
  4387.  
  4388.  
  4389.     @QSUM
  4390.     Syntax:  @QSUM("@X=Criterion",Range,Offset)
  4391.         Criterion = Value or formula to be used for match
  4392.         Range = Cell range
  4393.         Offset = Number of columns to the right/left on which to operate.
  4394.         Returns the sum of the records in the range that match the criterion.
  4395.  
  4396.         Example:    @QSUM("@X>5",A1..C3,0) = 31.3
  4397.  
  4398.  
  4399.     @QVAR
  4400.     Syntax:  @QVAR("@X=Criterion",Range,Offset)
  4401.         Criterion = Value or formula be used for match in top of row
  4402.         Range = Cell range
  4403.         Offset = Number of columns to the right/left on which to operate.
  4404.         Returns the population variance of the records in the range that
  4405.         match the criterion.
  4406.  
  4407.  
  4408.  
  4409.     @STD(Range)
  4410.         Range = Cell range to be evaluated
  4411.         Returns the standard deviation of the elements in the range.
  4412.  
  4413.         Example:
  4414.           @STD(A1..C3) =  2.904827
  4415.  
  4416.  
  4417.  
  4418.  
  4419.  
  4420.  
  4421.  
  4422.  
  4423.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [75] 
  4424.  
  4425.     @SUM
  4426.     Syntax:  @SUM(Range)
  4427.         Range = Cell range to be evaluated
  4428.         Returns the summation of the range.
  4429.  
  4430.         Examples:
  4431.           @SUM(A1..C3) = 44.6
  4432.           @SUM(A1..C3,R3,D9,X3..Y9) = 255.5
  4433.  
  4434.  
  4435.     @VAR
  4436.     Syntax:  @VAR(Range)
  4437.         Range =     Cell range to be analyzed
  4438.         Returns the population variance of the range.
  4439.  
  4440.         Example:
  4441.           @VAR(A1..C3) =  8.438024
  4442.  
  4443.  
  4444.  
  4445.     SPECIAL FUNCTIONS
  4446.     ~~~~~~~~~~~~~~~~~
  4447.     @CASE
  4448.     Syntax:  @CASE(Num,Arg2,....Argn)
  4449.         Num =  Any number or calculated value where Num > 0
  4450.         Arg1...ArgN =  Any number, string, character
  4451.  
  4452.         Returns the Numth argument from the argument list.
  4453.  
  4454.         Examples:
  4455.           @CASE(2,"A",17,"ABC",4) = 17
  4456.           @CASE(3,"Abc"&"d",129/4,@LEFT("Example",5),123) = Examp
  4457.                      |.........||....||......................||..|
  4458.                           :       :              :             :
  4459.                           :       :              :             :
  4460.                         First     :            Third           :
  4461.                        Argument   :           Argument         :
  4462.                                 Second                       Fourth
  4463.                                Argument                     Argument
  4464.  
  4465.  
  4466.     @COLS
  4467.     Syntax:  @COLS(Range)
  4468.         Range = Any cell Range.
  4469.         Returns the number of columns in the specified range.
  4470.  
  4471.         Examples:
  4472.           @COLS(A1..E121) = 5
  4473.           @COLS(AA11..BB32) = 27
  4474.           @COLS(TEST) = 6  where TEST = named range of (C5..H21)
  4475.  
  4476.     @HTABLE
  4477.     Syntax:  @HTABLE(Criterion,Range,Offset)
  4478.         Criterion =     Value to be used for match in top row of range
  4479.         Range =         Cell range which contains criterion range as top row
  4480.                         and includes data value table
  4481.  
  4482.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [76] 
  4483.         Offset =        Number of rows down in data value table from
  4484.                         which to return a value
  4485.  
  4486.         Returns the value at a vertical offset in the column that matches
  4487.         the criterion.
  4488.  
  4489.         @HTABLE(5.6,A1..C3,1) = 7.5
  4490.  
  4491.         The @HTABLE function operates as follows:
  4492.  
  4493.         Search starts at the upper left cell and proceeds until a value is
  4494.         found which is greater than the criterion. The position of the
  4495.         previous value is then used as a starting offset into the table.
  4496.         The offset is added to the top row and the value at the offset
  4497.         position is returned by the function.
  4498.  
  4499.  
  4500.  
  4501.     @HTERP
  4502.     Syntax:  @HTERP(Cell,Range,Offset)
  4503.         Perform a straight-line interpolation based on table specified by
  4504.         Range. It operates similar to @HTABLE function, but returns a
  4505.         result based on the following:
  4506.  
  4507.                  (Xv - Xi)
  4508.         Yv      ----------- x (Yi+1 - Yi)  +  Yi
  4509.                 (Xi+1 - Xi)
  4510.  
  4511.         Where X is the first row and Y is the offset row in the table.
  4512.  
  4513.  
  4514.  
  4515.     @INDEX
  4516.     Syntax:  @INDEX(Range,Col,Row)
  4517.         Range = Any cell Range
  4518.         Col, Row = Numeric value or value formula
  4519.         Searches the specified range and returns the element located Col
  4520.         columns to the right and Row rows down from the top left corner of
  4521.         the range.  Element may be a string or a value.
  4522.  
  4523.         Examples:
  4524.  
  4525.             /........A/........B/........C/
  4526.           1
  4527.           2         22        RR        HH
  4528.           3          A         1         2
  4529.           4         21        23         9
  4530.           5          b         F         3
  4531.  
  4532.          @INDEX(A2..C5,2,2) = 1
  4533.          @INDEX(A2..C5,3,1) = HH
  4534.          @INDEX(A2..C5,1,3) = 21
  4535.  
  4536.          Note that Col and Row have to satisfy the criteria:
  4537.             0 < Row < 8,192
  4538.             0 < Col < 255
  4539.  
  4540.  
  4541.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [77] 
  4542.     @LENGTH
  4543.     Syntax:  @LENGTH(Cell)
  4544.         Returns the length of the string in the referenced Cell (if the
  4545.         contents are a label), otherwise it returns zero if cell is empty.
  4546.         Note that the prefix character of a label is not considered in the
  4547.         length calculation.
  4548.  
  4549.  
  4550.     @LINK
  4551.     Syntax:  @LINK("Drive:\Path\Filename>Cell")
  4552.     NOTES: 1.  Double quotes and the '>' character are necessary.
  4553.            2.  If Drive:\Path are not specified, the search defaults to the
  4554.                the directory specified by the /Dir= command line switch,
  4555.                or with /File, Dir command.
  4556.  
  4557.         As the name indicates, it links cells in the current worksheet to
  4558.         cells in a worksheet on disk.  Once this function is entered, a
  4559.         link is created but it is not updated.  As a result, as soon as
  4560.         this function is entered, the cell frequently displays "N/A".  Do
  4561.         not panic, a newly created link is not updated until the /File,
  4562.         Uplink command is executed.  At that time, any value or string
  4563.         variable in the referenced cell of the indicated sheet on disk is
  4564.         retrieved and placed in the calling cell.
  4565.  
  4566.         Updating occurs automatically when the spreadsheet is first retrieved.
  4567.  
  4568.  
  4569.     @ROWS
  4570.     Syntax:  @ROWS(Range)
  4571.         Range = Any cell Range.
  4572.         Returns the number of rows in the specified range.
  4573.  
  4574.         Examples:
  4575.           @ROWS(A1..E121) = 121
  4576.           @ROWS(AA11..BB132) = 122
  4577.           @ROWS(TEST) = 17  where TEST = named range of (C5..H21)
  4578.  
  4579.  
  4580.     @USER
  4581.     Syntax:  @USER(Arg1,Arg2,Arg3)
  4582.         USER = User provided name of function (any unique name)
  4583.         Arg1,Arg2,Arg3 = User provided numeric arguments
  4584.         This is a special function, defined by the user, which can have up
  4585.         to three numeric arguments.  The user specifies the formula which
  4586.         relates the arguments and creates a unique range name which
  4587.         includes the cells containing the formula and the arguments.  The
  4588.         function may then be used in the worksheet just as any other
  4589.         internal @ function.  To set up the function, perform the
  4590.         following steps:
  4591.  
  4592.         1.  Place up to three numeric arguments, Arg1, Arg2, Arg3, in a
  4593.         single row in adjacent columns.
  4594.  
  4595.         2.  Place the formula which relates the numeric values in the cell
  4596.         below Arg1, the leftmost argument.
  4597.  
  4598.  
  4599.  
  4600.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [78] 
  4601.         3.  Give a unique range name to the block which includes the
  4602.         arguments and the formula.  This range name will become the
  4603.         function name.
  4604.  
  4605.         4.  Use the newly defined function.
  4606.  
  4607.  
  4608.  
  4609.     @VTABLE
  4610.     Syntax:  @VTABLE(Criterion,Range,Offset)
  4611.         Criterion   =   Value to be used for match in left column of range
  4612.         Range       =   Cell range which contains criterion range as left
  4613.                         column and includes data value table
  4614.         Offset      =   Number of columns to the right in data value table
  4615.                         from which to return a value.  The first criterion
  4616.                         column in the range has an offset of zero.
  4617.  
  4618.         Returns the value at a horizontal offset in the row that matches
  4619.         the criterion.  The @VTABLE function operates as follows:
  4620.  
  4621.         Search starts at the upper left cell and proceeds downwards row by
  4622.         row until a value is found which is greater than the criterion.
  4623.         The position of the previous value is then considered as a match.
  4624.         The offset is added to the left column and the value at the offset
  4625.         position is returned by the function.
  4626.  
  4627.         NOTE: Table values outside the search region cause an error result.
  4628.  
  4629.  
  4630.     @VTERP
  4631.     Syntax:  @VTERP(Cell,Range,Offset)
  4632.         Similar to @HTERP, but scans vertically (row by row).
  4633.  
  4634.  
  4635.  
  4636.  
  4637.  
  4638.  
  4639.  
  4640.  
  4641.  
  4642.  
  4643.  
  4644.  
  4645.  
  4646.  
  4647.  
  4648.  
  4649.  
  4650.  
  4651.  
  4652.  
  4653.  
  4654.  
  4655.  
  4656.  
  4657.  
  4658.  
  4659.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [79] 
  4660.  
  4661.     DATE AND TIME FUNCTIONS
  4662.     ~~~~~~~~~~~~~~~~~~~~~~~
  4663.     The functions below are based on the number of days elapsed since
  4664.     January 1, 1900. In order to have the value displayed in a date form,
  4665.     the cell(s) have to be formatted with one of the date formats (see
  4666.     formatting section).
  4667.  
  4668.  
  4669.     @DATE
  4670.     Syntax:  @DATE(Year,Month,Day)
  4671.         Year    =   Value corresponding to last two digits of year
  4672.         Month   =   Value corresponding to month of year, 1-12
  4673.         Day     =   Value corresponding to day of month, 1-31
  4674.         Returns a unique integer for each day since January 1, 1900.
  4675.  
  4676.         Example:
  4677.             @DATE(91,11,1) returns an integer of 33543.  If the cell is
  4678.             formatted as Date MM/DD/YY, then the date 11/1/91 is displayed.
  4679.  
  4680.  
  4681.     @DATEVAL
  4682.     Syntax:  @DATEVAL("MM/DD/YY")
  4683.         Convert the string argument to a date number representing the
  4684.         month(MM):day(DD):year(YY).  Note that the cell can be formatted to
  4685.         display the above VALUE in a date format.
  4686.  
  4687.         Examples:
  4688.           @DATEVAL("6/15/89")             = 32674  (Unformatted cell)
  4689.           @DATEVAL("6/15/89")             = 06/15/89  (Formatted cell)
  4690.           @DATEVAL("7"&"/6"&"/89")        = 07/06/89  (Formatted cell)
  4691.           @DATEVAL(A6)                    = 10/13/89  (Formatted cell)
  4692.                                             where cell A6 contains the
  4693.                                             string "10/13/89"
  4694.  
  4695.           NOTE: Spaces, colons, semicolons, and other non-numberic
  4696.                 characters are acceptable delimeters.
  4697.  
  4698.  
  4699.     @DAY
  4700.     Syntax:  @DAY(x)
  4701.         x = the number of days since Jan. 1, 1900.
  4702.         Based on a unique day assigned to 'x', computes the day in the
  4703.         month of that date.
  4704.  
  4705.         Example:
  4706.           @DAY(33543) returns the number 1
  4707.           (The date number is equivalent to November 1, 1991)
  4708.  
  4709.  
  4710.     @HOUR
  4711.     Syntax:  @HOUR(Value)
  4712.         Value   =   Any number or calculated value in fractional days
  4713.                     i.e., 1 day = 24 hours, 0.5 day = 12 hours
  4714.         Returns the hours corresponding to the fractional portion of
  4715.         Value.  The integer portion of Value (representing days) is
  4716.         ignored.
  4717.  
  4718.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [80] 
  4719.         Examples:
  4720.           @HOUR(0.5)      = 12
  4721.           @HOUR(3/4)      = 18
  4722.           @HOUR(0.25)     =  6
  4723.           @HOUR(9.25)     =  6
  4724.  
  4725.  
  4726.     @MINUTE
  4727.     Syntax:  @MINUTE(Value)
  4728.         Value = Any number or calculated value in fractional days
  4729.         Returns the minutes corresponding to the fractional portion of Value.
  4730.         The integer portion of Value (representing days) is ignored.
  4731.  
  4732.         Examples:
  4733.           @MINUTE(0.51)  = 14
  4734.           @MINUTE(0.33)  = 55
  4735.           @MINUTE(3.33)  = 55
  4736.  
  4737.  
  4738.     @MONTH
  4739.     Syntax:  @MONTH(x)
  4740.         x = the number of days since January 1, 1900.
  4741.         Based on a unique day assigned to "x", computes the month in which
  4742.         that day occurs.
  4743.  
  4744.         Example:
  4745.           @MONTH(33543) returns the number 11.
  4746.           (The date number is equivalent to November 1, 1991)
  4747.  
  4748.     @SECOND
  4749.     Syntax:  @SECOND(Value)
  4750.         Value = Any number or calculated value in fractional days
  4751.         Returns the seconds corresponding to the fractional portion of
  4752.         Value. The integer portion of Value (representing days) is
  4753.         ignored.
  4754.  
  4755.         Examples:
  4756.            @SECOND(0.511)      = 50
  4757.            @SECOND(0.541)      =  2
  4758.            @SECOND(9.541)      =  2
  4759.  
  4760.     @TIME
  4761.     Syntax:  @TIME(Hr,Min,Sec)
  4762.         Hr  = A number between 0 and 23, Hours
  4763.         Min = A number between 0 and 59, Minutes
  4764.         Sec = A number between 0 and 59, Seconds
  4765.         Returns a fractional time serial number represented by Hr:Min:Sec.
  4766.         Note that in order to have a cell containing this function display
  4767.         in time format, you have to format it using /Range, Format, Date 5
  4768.         or 6.
  4769.  
  4770.  
  4771.     @TIMEVAL
  4772.     Syntax:  @TIMEVAL("HH:MM:SS")
  4773.         HH =    Value representing number of hours
  4774.         MM =    Value representing number of minutes
  4775.         SS =    Value representing number of seconds
  4776.  
  4777.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [81] 
  4778.         Convert the string argument to a real number representing the
  4779.         hour(s):minute(s):second(s) as a fraction of a day.  Note that the
  4780.         cell can be formatted to display the above VALUE in a time format.
  4781.  
  4782.         Examples:
  4783.           @TIMEVAL("1:2:3")        = 0.04309027  (Unformatted cell)
  4784.           @TIMEVAL("1:2:3")        = 1:02        (Cell formatted for time)
  4785.           @TIMEVAL("1:2:120")      = 1:04                     ''
  4786.           @TIMEVAL("1:70:120")     = 2:12                     ''
  4787.           @TIMEVAL("25:2:120")     = 1:04                     ''
  4788.  
  4789.           NOTE: The time value is calculated using the following formula:
  4790.  
  4791.                 Hour + Min/60 + Second/3600
  4792.                 --------------------------
  4793.                            24
  4794.  
  4795.  
  4796.     @TODAY
  4797.         Returns the unique number corresponding to today's date and time
  4798.         referenced to January 1, 1900.
  4799.  
  4800.         @TODAY returns the number 33543 if today is November 1, 1991.  If
  4801.         the cell were formatted as Date D-M-Y, then the date 1-Nov-91 is
  4802.         displayed.
  4803.  
  4804.         If the cell were formatted as Date 6 (H:M:S), then the time
  4805.         associated with the fractional part of the date is displayed.
  4806.  
  4807.         NOTE:   @TODAY is NOT automatically updated when a spreadsheet
  4808.                 is retrieved, even if the recalculation mode is set for
  4809.                 automatic.  You must recalc the spreadsheet by manually
  4810.                 pressing the [F9] function key or by macro command.
  4811.  
  4812.  
  4813.     @YEAR
  4814.     Syntax:  @YEAR(x)
  4815.         x = the number of days since January 1, 1900.
  4816.         Based on a unique day assigned to 'x', computes the year in which that
  4817.         day occurs.
  4818.  
  4819.         Example:
  4820.            @YEAR(33543) returns the number 91.
  4821.  
  4822.  
  4823.  
  4824.  
  4825.  
  4826.  
  4827.  
  4828.  
  4829.  
  4830.  
  4831.  
  4832.  
  4833.  
  4834.  
  4835.  
  4836.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [82] 
  4837.     10.   MACROS
  4838.     ~~~~~~~~~~~
  4839.     A macro is a sequence of keystrokes which may be activated by pressing
  4840.     the combination of the Alt key and a letter key or by using the [F3]
  4841.     key -macro execute.  An example macro would be the following:
  4842.  
  4843.          {RT}{RT}{DN}
  4844.  
  4845.     The words/letters in braces represent an action keystroke.  The above
  4846.     macro will move the pointer two cells to the right and one cell down.
  4847.     A macro may be placed in any cell.
  4848.  
  4849.     To activate a macro with the [ALT] key, it must have a special type of
  4850.     range name assigned to its location.  The special range name is the
  4851.     backslash [\] followed immediately by any letter from 'A' thru 'Z'.
  4852.     For example:
  4853.  
  4854.          \A
  4855.  
  4856.     This specific macro may be activated by pressing the [ALT] key and the
  4857.     letter 'A' simultaneously.  Therefore, even though the backslash is
  4858.     used to define the range name it actually represents the [alt] key.
  4859.  
  4860.     If you desire a macro to automatically execute upon retrieval of a
  4861.     spreadsheet, name your macro "\0" ( Zero).  When AS-EASY-AS retrieves
  4862.     your spreadsheet, it searches for a macro named "\0".  If one exists,
  4863.     it is automatically executed.  You can have only one auto-executing
  4864.     macro in a spreadsheet.
  4865.  
  4866.     NOTE: To edit an auto-executing macro, it may be necessary to use the
  4867.           /File Merge command to keep the macro from auto-executing as
  4868.           it would if /File Retrieve were used.
  4869.  
  4870.  
  4871.     DEFINING A MACRO
  4872.     ~~~~~~~~~~~~~~~~
  4873.     The powerful macros that are supported by AS-EASY-AS provide a
  4874.     complete programming environment for most applications.  Macros can be
  4875.     chained together to provide self running applications that do
  4876.     virtually anything that can be done manually through the command mode.
  4877.  
  4878.     Macro commands can be typed in directly from the keyboard.  This
  4879.     requires that you know the exact sequence of macro commands to perform
  4880.     the desired action ahead of time.
  4881.  
  4882.     For short macros, this method is acceptable.  However, if you have a
  4883.     long macro to create, or if you are unfamiliar with the sequence of
  4884.     commands needed, AS-EASY-AS provides an alternative method for
  4885.     creating macros.
  4886.  
  4887.     AS-EASY-AS has the ability to learn by example, it records your
  4888.     keystrokes as you perform the desired task, and writes them out to the
  4889.     sheet as macro commands.  To access this macro recording ability,
  4890.     select /Sheet, Macro, Compose.
  4891.  
  4892.     When you first select Compose, AS-EASY-AS starts recording all your
  4893.     keystrokes.  The macro compose buffer is capable of storing 2048
  4894.  
  4895.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [83] 
  4896.     characters. When you have completed your macro, reselect /Sheet,
  4897.     Macro, Compose a second time.
  4898.  
  4899.     AS-EASY-AS will prompt you for the cell location in which to place the
  4900.     macro commands.  Simply point to a vacant cell or type in the cell
  4901.     location and hit [ENTER].  The macro commands will be entered,
  4902.     continuing to the next rows below as necessary, writing over any
  4903.     information currently in the cells.
  4904.  
  4905.  
  4906.     EXECUTING A MACRO
  4907.     ~~~~~~~~~~~~~~~~~
  4908.     There are several ways to execute your macro.  The first step is to
  4909.     name your macro.  To define a range name, type the following:  /rnc
  4910.     which stands for /RANGE, NAME, CREATE.
  4911.  
  4912.     After you press the letter 'c'(for Create) the spreadsheet will prompt
  4913.     YOU for the name of the range.  Now type the range name and then press
  4914.     the [ENTER] key.  (Be careful, don't include any spaces in the range
  4915.     name).
  4916.  
  4917.     The next step involves typing (or pointing) the cell which the macro
  4918.     occupies. If the macro was in cell A1, then type A1 [ENTER].  The
  4919.     simplest method of executing macros is to name your macro using the
  4920.     special range name character \ followed by a single letter as
  4921.     discussed previously.
  4922.  
  4923.     Pressing the [ALT] key and the letter name of your macro
  4924.     simultaneously will execute your macro.  Naming your macro \0 (zero)
  4925.     will create a macro that will auto execute each time the spreadsheet
  4926.     is retrieved.
  4927.  
  4928.     A second execution method is to press the [F3] Macro Execute function
  4929.     key. Type in the name of your macro and hit [ENTER], and AS-EASY-AS
  4930.     will execute your macro.
  4931.  
  4932.     If you can't remember your macro name, press [F3] then [F1].  A pick
  4933.     window of all the range names will appear in the middle of your
  4934.     screen. Highlight the name of your macro and hit [ENTER] to execute
  4935.     the macro.
  4936.  
  4937.     A third method to execute your macro is by selecting /Sheet, Macro,
  4938.     Execute. You are allowed to specify a cell address, a named range,
  4939.     etc. Again, pressing [F1] after this option has been selected will
  4940.     display all named ranges in a pick window on the screen.
  4941.  
  4942.     Because of its execution speed, it may be difficult to follow your
  4943.     macro commands to determine if your macro is performing as planned.
  4944.     To assist you in your debugging efforts, AS-EASY-AS provides the
  4945.     ability to execute your macro one command at a time.
  4946.  
  4947.     /Sheet, Macro, Step toggles the macro step execution on and off.  If
  4948.     the option Yes is selected, you are asked to specify the number of
  4949.     msec of delay between macros ( 0 < D < 5000 msec).  If a delay of
  4950.     zero, (D=0), is specified, the program will pause after each macro
  4951.     command, until you press any key to continue.  The currently executing
  4952.     macro command will also be displayed at the bottom of the screen.
  4953.  
  4954.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [84] 
  4955.     MACRO KEYWORDS
  4956.     ~~~~~~~~~~~~~~
  4957.     All menu commands in AS-EASY-AS can be invoked from within a macro
  4958.     with the key-letter (the first letter in the command).  In addition,
  4959.     the following cursor movements have macro keywords:
  4960.  
  4961.      MACRO
  4962.      COMMAMD             MEANING
  4963.     ~~~~~~~~~            ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  4964.     {LT  X}         -    Move cursor X cells to the Left
  4965.     {RT  X}         -    Move cursor X cells to the Right
  4966.     {DN  X}         -    Move cursor X cells Downward
  4967.     {UP  X}         -    Move cursor X cells Upward
  4968.     {PGUP  X}       -    Move cursor X pages Up
  4969.     {PGDN  X}       -    Move cursor X pages Down
  4970.     {PGRT  X}       -    Move the cursor X pages to the Right
  4971.     {PGLT  X}       -    Move the cursor X pages to the Left
  4972.     {DEL  X}        -    Delete X characters to the right of cursor
  4973.     {BS  X}         -    Backspace X characters to the Left of the cursor
  4974.     {INS}           -    Same cursor as the [INS] key.  Toggles between
  4975.                          Insert and Overtype modes
  4976.     {INSON}         -    Toggles the Insert mode on
  4977.     {INSOFF}        -    Toggles the Insert mode off
  4978.     {HOME}          -    Move cursor to cell A1
  4979.     {END}           -    Same as the [END] key
  4980.     {EDIT}          -    Places the current cell in the Edit mode [F2]
  4981.     {NAME}          -    Name, show matrix of names same as [F3]
  4982.     {ABS}           -    Make cell reference absolute [F4]. Toggles
  4983.                          between ABS modes.
  4984.     {GOTO cell}     -    GoTo a specified cell, [F5]
  4985.     {WINDOW}        -    If window active toggles the cursor between
  4986.                          windows otherwise toggle the cursor between
  4987.                          the current and previous cursor locations, [F6]
  4988.     {VIEW}          -    Toggle the current view between the opened
  4989.                          windows, same as [F7]
  4990.     {CALC}          -    Recalculate all cells, [F9]
  4991.     {GRAPH}         -    View the specified graph, [F10]
  4992.     {ESC X}         -    Represents the [ESC] (Escape) key (X is
  4993.                          optional).
  4994.          ~          -    Tilde (~), same as the [ENTER] key
  4995.  
  4996.     NOTES:
  4997.       The keystroke [ENTER] in a macro is represented by the
  4998.       tilde (~).
  4999.  
  5000.       All macro commands MUST be enclosed in curly braces {}.
  5001.  
  5002.       The X in the above listing is optional, i.e., {RT 5} moves the
  5003.       cursor to the right 5 cells, whereas {RT} moves the cursor
  5004.       to the right just one cell.
  5005.  
  5006.     Macros are executed from left to right in a given cell and proceed
  5007.     downwards row by row until either a blank cell is reached, the [ESC]
  5008.     key is pressed, or the {QUIT} macro keyword is executed.
  5009.  
  5010.  
  5011.  
  5012.  
  5013.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [85] 
  5014.     ADVANCED MACROS
  5015.     ~~~~~~~~~~~~~~~
  5016.     The advanced macro capabilities of AS-EASY-AS complete a powerful
  5017.     programming environment.  Using these macros, you can set up your own
  5018.     custom menus, set up programming loops, branching and execute sub-
  5019.     routines.
  5020.  
  5021.     NOTE:   All commands below may ONLY be used in an executing
  5022.             macro.
  5023.  
  5024.     {?}
  5025.         Pauses macro execution and awaits keyboard input.  Useful for
  5026.         interrupting macro to allow movement around sheet or entry of
  5027.         data. Macro execution continues only after [ENTER] or [ESC] is
  5028.         pressed.
  5029.  
  5030.         NOTE: [ENTER] and [ESC] characters will not appear in the macro
  5031.               stream.  You must provide them where required to terminate
  5032.               input in response to a prompt.
  5033.  
  5034.  
  5035.     {APPEND F#, "FileName"}
  5036.         F# - File Number (1, 2, 3, 4, or 5)
  5037.         Filename - Name of File, may include drive and path information
  5038.  
  5039.         Open FileName in Append mode. See {OPEN} command.  Subsequent
  5040.         WRITES to the file will cause text to be appended to the end of the file.
  5041.  
  5042.         NOTE:  Any file which is opened with {APPEND}, must be closed
  5043.                with the {CLOSE} macro command before exiting from AS-
  5044.                EASY-AS.  Failure to do so will result in the file information
  5045.                becoming corrupted and unusable.
  5046.  
  5047.  
  5048.     {BEEP X}
  5049.         Produces a beep sound.  This macro could be useful at the end of
  5050.         unattended macro(s) to signal the user that some task is
  5051.         completed, or to get the user's attention when a prompt for
  5052.         information is introduced. Also see {TONE X,Y}.
  5053.  
  5054.  
  5055.     {BLANK Range}
  5056.         Erases the cells in the range defined by 'Range'.  The effect is
  5057.         the same as when executing the /re command.  This method is
  5058.         sometimes more desirable than /re since it will not display the
  5059.         menus as does /re when it is used in a macro.
  5060.  
  5061.  
  5062.  
  5063.     {BORDEROFF}
  5064.         This macro command is used to turn the column and row borders off.
  5065.         It's function is the same as the /sbs menu command.  Once this
  5066.         macro is invoked, the borders of the sheet, i.e., the portion
  5067.         containing the row numbers, become invisible until a {BORDERON}
  5068.         command is invoked.
  5069.  
  5070.  
  5071.  
  5072.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [86] 
  5073.     {BORDERON}
  5074.         This macro command  cancels the {BORDEROFF} macro.  You might note
  5075.         that the screen needs to be updated, using the {UPDATE} macro
  5076.         after {BORDERON} is invoked.
  5077.  
  5078.  
  5079.     {CALL Location}  or {RangeName}
  5080.         Call the subroutine identified by 'location'.  This is different
  5081.         than the {JUMP} command.  {JUMP} transfers execution of the macro
  5082.         to a given location but 'forgets' its current position.  {CALL},
  5083.         on the other hand, transfers execution to another location.
  5084.  
  5085.         When a {RET} command is encountered, it returns execution to the
  5086.         next command following the calling cell and continues with the
  5087.         macro. Subroutines may be nested (they can call more subroutines)
  5088.         up to 20 levels deep.
  5089.  
  5090.         Any macro command sequence can be called as a subroutine.  Macro
  5091.         commands can call themselves as subroutines (i.e., they can be
  5092.         recursive).  Improperly designed recursive macros can result in
  5093.         serious problems and will cause the macro stack overflow error.
  5094.  
  5095.  
  5096.     {CLOSE F#}
  5097.         F# - File Number (1, 2, 3,...)
  5098.  
  5099.         Close disk file F#.  See {OPEN}, {READ}, {WRITE}, and {APPEND}
  5100.         macro commands.
  5101.  
  5102.         As an example, {CLOSE 1} will close disk file #1.
  5103.  
  5104.  
  5105.     {CLRSCR}
  5106.         Clears the screen, so that a messages can be written for
  5107.         presentations, etc.  The screen remains in this mode until an
  5108.         {UPDATE} macro command is executed or the macro terminates.
  5109.  
  5110.  
  5111.     CURSOR
  5112.         This variable may only be used in edit or macro modes and refers to the
  5113.         cell occupied by the current position of the cursor.
  5114.  
  5115.         Example:
  5116.           Assume that cells A1 through A100 contain the values 1., 3., 4.5,
  5117.           and 8. randomly distributed.  Let's say that you want to replace
  5118.           all occurrences of the value 8. with 1.25.
  5119.  
  5120.         The following macro would do the trick for you:
  5121.  
  5122.         Cell    Contents                             Explanation
  5123.         ~~~~    ~~~~~~~~~~~~~~~~~~~~~~               ~~~~~~~~~~~
  5124.         B1      0                                    Set a counter cell
  5125.         B2      {LET B1,0}{GOTO A1}                  Go to beginning of
  5126.                                                      range
  5127.         B3      {If CURSOR=8}{LET CURSOR,1.25}       Set the criterion
  5128.         B4      {LET B1,B1+1}                        Increase counter by
  5129.                                                      1.
  5130.  
  5131.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [87] 
  5132.         B5      {IF B1=100}{JUMP OUT}                Check if all 100 cells
  5133.                                                      have been processed (if
  5134.                                                      the counter cell reached
  5135.                                                      100). If yes, jump out of
  5136.                                                      the loop.
  5137.         B6      {DN}                                 Move the cursor down
  5138.                                                      one cell.
  5139.         B7      {JUMP BEGIN}                         Repeat the loop
  5140.         B8      {QUIT}                               Stop executing macro.
  5141.  
  5142.         **  Don't forget to define the following range names:
  5143.  
  5144.         Range Name               Cell
  5145.         ~~~~~~~~~~               ~~~~
  5146.          BEGIN                    B3
  5147.          OUT                      B8
  5148.          \A                       B2 <-Press Alt-A to start macro
  5149.  
  5150.  
  5151.     {DELAY X}
  5152.         This macro command will halt program execution for  the specified
  5153.         (X) number of thousands of a second  within a macro, ONLY while
  5154.         displaying a graph or the Sheet Status screen.  A delay of X equal
  5155.         to 0 resets the pause mechanism to wait until a key has been
  5156.         pressed.  This could be useful in displaying a graph for a given
  5157.         amount of time, before continuing execution of the macro.
  5158.  
  5159.  
  5160.     {ESCON} and {ESCOFF}
  5161.         Disables/enables the escape key which would normally permit a
  5162.         macro to be aborted.
  5163.  
  5164.     CAUTION: {ESCOFF} should be used only if other provisions for
  5165.              exiting a macro have been made.  If no such provisions
  5166.              exist, you are liable to end up in an infinite loop, with
  5167.              the only way out being to reboot your computer.
  5168.  
  5169.  
  5170.     {EXIT}
  5171.         Cancels one/top level of subroutine calls and allows macro
  5172.         programming to continue.  This macro command was built into AS-
  5173.         EASY-AS to allow the user flexibility when a forced exit out of
  5174.         subroutines and loops is desired.
  5175.  
  5176.  
  5177.     {FOR COUNTER, START, STOP, STEP}
  5178.         Counter  =  Cell location which keeps track of the number of macro
  5179.                     iterations
  5180.         Start    =  The beginning value for the counter
  5181.         Stop     =  The end value for the counter
  5182.         Step     =  The incremental value to be added to counter after
  5183.                     each iteration
  5184.         Executes the macro commands which follow until {NEXT} is
  5185.         encountered.  The counter is increased by the value of step.  If
  5186.         the new counter value does not exceed the step value, the macro
  5187.         loop is repeated again.  This continues until the counter exceeds
  5188.         the stop value at which time execution transfers to the macro
  5189.  
  5190.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [88] 
  5191.         command cell below {NEXT}.
  5192.  
  5193.         NOTES:  1.  If Stop is initially less than the Start value, the macro
  5194.                     loop will be skipped and execution transferred to the cell
  5195.                     below.
  5196.  
  5197.                 2.  If Step is set equal to 0 (zero), an infinite loop will be
  5198.                     created as the counter will never exceed the Stop value.
  5199.  
  5200.                3.   A maximum of 4 nested {FOR}{NEXT} loops may be
  5201.                     created.
  5202.  
  5203.  
  5204.     {GET CELL}
  5205.         This command accepts the next character from the keyboard and
  5206.         places it in CELL. (This occurs as soon as you depress a keyboard
  5207.         key you do not need to press [ENTER]).  For example, {GET A13}
  5208.         stops and waits until a key is pressed.  If the Key "A" is
  5209.         pressed, then "A" is placed in cell A13.
  5210.  
  5211.  
  5212.     {GOTOXY A1,A2}
  5213.         Places the character cursor at the column and row screen
  5214.         coordinate specified by A1 and A2.  A1 is the column (1..80) and
  5215.         A2 is the row (1..25) of that coordinate.   Subsequent use of the
  5216.         {WRITE} macro will place text at the current cursor position.
  5217.  
  5218.         Example:       {Gotoxy 20,12}
  5219.                        {Write "This text is in the middle of the screen"}
  5220.  
  5221.  
  5222.     {IF Condition}Action...
  5223.         If the 'condition' is met, then proceed with the identified
  5224.         'action' in the same cell, otherwise continue with the macro in
  5225.         the cell below this command.  This macro command is very similar
  5226.         to the if-then-else structure found in many programming languages.
  5227.  
  5228.         It is important to remember, however, that the "then" action must
  5229.         follow in the same cell as the IF test.
  5230.  
  5231.         Example:       {goto A1}~Macro Example~
  5232.                        {IF Test>2}{JUMP A50}
  5233.                        {calc}
  5234.  
  5235.         Explanation:  Position cursor on cell A1. Place the string 'Macro
  5236.         Example' in that cell.  If the value of the cell named 'Test' is
  5237.         greater than 2, go  to cell A50 and start executing the macro in
  5238.         that cell.  If the value of 'Test' is less than 2, then
  5239.         recalculate the spreadsheet.
  5240.  
  5241.  
  5242.  
  5243.     {INDXY m,n}
  5244.         Sets the location of the mode indicator, to line (m) and column
  5245.         (n). (This is the area displaying the messages "Ready, Macro,
  5246.         Wait, etc.). The value for "m" must be 1-24 and that for "n" must
  5247.         be 1-80.
  5248.  
  5249.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [89] 
  5250.     {INKEY CELL}
  5251.         Pauses execution of the macro and stores a single typed character
  5252.         in CELL. Macro execution continues after the key has been pressed.
  5253.  
  5254.  
  5255.     {INLABEL "Prompt", Location}
  5256.     {INVALUE "Prompt", Location}
  5257.         Display the text 'Prompt' on the control panel and pause for
  5258.         input.  The user can type a label (text string), or a value, and
  5259.         when [ENTER] is pressed, the label, or the value, is placed in the
  5260.         cell identified by 'Location'.
  5261.  
  5262.         Example:       {INLABEL "Enter Your Name",A5}
  5263.             Explanation:  Display the prompt 'Enter Your Name' in the
  5264.             control panel and pause.  When a user types his name and
  5265.             presses [ENTER], the name is placed in cell A5.
  5266.  
  5267.  
  5268.     {INRANGE "Prompt",Cell}
  5269.         This macro command prompts the user for a cell range.  The range
  5270.         can be defined using the pointing method (or the typing method)
  5271.         and the result is placed in cell.
  5272.  
  5273.         Example:
  5274.           The Macro {InRange " What is the Erase Range", d2} would place the
  5275.           prompt 'What is the Erase Range' in the panel area and wait for
  5276.           input.
  5277.  
  5278.           If the user presses:
  5279.  
  5280.               [HOME]
  5281.                 .      <----- (Period)
  5282.               [DOWN]
  5283.               [DOWN]
  5284.               [RIGHT]
  5285.               [ENTER]
  5286.  
  5287.           The text A1..B3, representing the highlighted range, would be
  5288.           placed in cell D2.
  5289.  
  5290.  
  5291.     {IOINIT "COMn:Baud,PA,DB,SB,LEN,DL"}
  5292.          Initialize the serial port COMn where n=1,2,3,4.
  5293.          Baud      =    Baud Rate (300, 1200, 2400, .....)
  5294.          PA        =    Parity (E, O, N, ...)
  5295.          DB        =    Data Bits (Normally 7 or 8)
  5296.          SB        =    Stop Bits (Normally 1 or 2)
  5297.          LEN       =    Maximum length of string that will be transmitted or
  5298.                         accepted as input (Default is 80)
  5299.          DL        =    Delay in units of System Cycles.
  5300.  
  5301.         This macro command is used to initialize one of the computer's
  5302.         serial ports for subsequent use of the {IOVALUE} and {IOLABEL}
  5303.         macro commands.
  5304.  
  5305.         Example:
  5306.           {IOINIT "COM2:2400,N,8,1,80,2000"}
  5307.  
  5308.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [90] 
  5309.           Initialize serial port 2 for 2400 baud, No parity, 8 data bits, 1
  5310.           stop bit, a maximum string length of 80, and a delay of 2000
  5311.           system cycles.
  5312.  
  5313.  
  5314.     {IOLABEL "String",Range}
  5315.         Transmit String to the initialized communications port and store
  5316.         the received information, as a label, in Range.  You may leave
  5317.         String blank ('''')if you just want to get information from the
  5318.         port without sending anything.  Conversely, use the range name NUL
  5319.         if you are just sending information to the port.
  5320.  
  5321.         Example:       {IOLABEL "ATDT12345667&@CHR(13),NUL}
  5322.             Send the dial up sequence ATDT1234567, followed by CR to
  5323.             the initialized serial port.  No information expected to come
  5324.             back to AS-EASY-AS, Range = NUL.
  5325.  
  5326.  
  5327.     {IOVALUE "String",Range}
  5328.         Transmit String to the initialized communications port and store
  5329.         the received information, as a label, in Range.  You may leave
  5330.         String blank ('''')if you just want to get information from the
  5331.         port without sending anything.  Conversely, use the range name NUL
  5332.         if you are just sending information to the port.
  5333.  
  5334.         Example:  {IOVALUE "",A2}
  5335.             Receive information from the serial port (in this case from
  5336.             the other computer), and place it in Cell A2.
  5337.  
  5338.             {IF @FIND(":?",A2,1)>0}{IOVALUE +F1,NUL}
  5339.             Check to see if the string that was received from the serial
  5340.             port, and placed in cell A2, contains the substring ":?".  If it
  5341.             does, then transmit the value in cell F1 to the serial port.
  5342.  
  5343.  
  5344.     {JUMP Location}
  5345.         This macro instructs the program to continue executing at a new
  5346.         'location'.  The 'location' can either be a cell location (A1,
  5347.         B345, AG5) or a range name that was created with the /Range, Name,
  5348.         Create command.
  5349.  
  5350.         Be careful, this command is different than the {GOTO} macro
  5351.         command. {JUMP} simply tells the program which macro to execute
  5352.         next, whereas, {GOTO} transfers the cell pointer to the specified
  5353.         cell.
  5354.  
  5355.         Example:   {goto A1}~Macro Example~
  5356.                    {JUMP A50}
  5357.  
  5358.  
  5359.         Explanation:  Go to cell A1, place the string 'Macro Example' in
  5360.         that cell and then jump to cell A50 and execute the macro in that
  5361.         cell, while the cell pointer is still at A1.
  5362.  
  5363.  
  5364.  
  5365.  
  5366.  
  5367.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [91] 
  5368.     {LET A1,EXPRESSION}
  5369.         Evaluates the formula "EXPRESSION", and places the value in A1.
  5370.         Use of this command does not require that you physically move the
  5371.         cursor to A1 before entering data, therefore, it can reduce
  5372.         moving back and forth between various portions of the worksheet.
  5373.         EXPRESSION can be any valid mathematical or logical expression.
  5374.  
  5375.         Example:  {Let A3,A3+1} increments the value in cell A3 by one.
  5376.  
  5377.         NOTE:  There is no space between the "," and "Expression".
  5378.  
  5379.  
  5380.     {MENUCALL Location}
  5381.         Transfers execution to macro menu at "Location".  Allows the user
  5382.         to make a menu selection, and then CALLS the macro identified by
  5383.         that menu selection.  When {RET} is encountered, macro execution
  5384.         continues with the command following the {MENUCALL}.
  5385.  
  5386.         See {MENUJUMP} for instructions on defining your own menu.
  5387.  
  5388.  
  5389.     {MENUJUMP Location}
  5390.         Transfers execution to the macro menu at "Location".  Allows the
  5391.         user to make a menu selection, and then executes the macro
  5392.         identified below that menu selection.
  5393.  
  5394.         The macro menu has to follow the guidelines given below:
  5395.  
  5396.          -    Two rows are used for the creation of the menu.  Each menu
  5397.               option can be up to 30 characters long.
  5398.          -    The cell to the right of the last item of the menu must be empty
  5399.               to indicate the end of the menu.
  5400.  
  5401.          -    Each selection is placed in an individual cell in the first row.
  5402.  
  5403.          -    Each cell in the second row contains the explanation of the
  5404.               command in the cell above it.  Whenever the user moves the
  5405.               cursor highlighting one of the menu options, the control panel
  5406.               displays the explanation for that menu selection.
  5407.  
  5408.         A macro menu performs identically to the standard AS-EASY-AS
  5409.         command menus.
  5410.  
  5411.  
  5412.  
  5413.         HINTS:   1.   Avoid menu entries that start with the same character
  5414.                       so that an option can be selected by typing the unique
  5415.                       first letter.
  5416.                  2.   AS-EASY-AS will assign the next unique letter in the
  5417.                       command if a duplicate occurs.
  5418.                  3.   Upper case and lower case letters are considered equal.
  5419.  
  5420.         When a user selects one of the items in the menu, AS-EASY-AS
  5421.         starts execution of the macro on the third row in the column of
  5422.         the selected menu choice.
  5423.  
  5424.  
  5425.  
  5426.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [92] 
  5427.     {MENUOFF}
  5428.         Disables the screen update of the panel and pop-up window menus.
  5429.         Invoking this command will speed the operation of macros that
  5430.         frequently update the screen.
  5431.  
  5432.  
  5433.     {MENUON}
  5434.         Restores screen update of the panel and pop-up window menus.  This
  5435.         command should be invoked at the end of a macro that used
  5436.         {MENUOFF}.
  5437.  
  5438.  
  5439.     {MENUWIDTH x}
  5440.         Specify a width of x (up to 28 characters) for the menu window.
  5441.         Once a menu width is specified, it stays in affect until a new
  5442.         {MENUWIDTH x} macro command is issued.
  5443.  
  5444.  
  5445.     {MENUXY x,y}
  5446.         Specify the x,y coordinate of the upper left corner of menu
  5447.         window.  If the period key [.] is pressed while a menu is
  5448.         displayed at x,y, the menu position will toggle between the left
  5449.         and the right side of the screen, i.e., the x coordinate above
  5450.         will be overridden, but the vertical position of the menu will not
  5451.         change until a new {MENUXY x,y} macro command is used.
  5452.  
  5453.  
  5454.     {OPEN F#,M#,"Filename"}
  5455.          F# - File Number (1, 2, 3, 4, or 5)
  5456.          M# - Mode (1, 2 or 3)
  5457.               1 - Read -  Allows the file to be read.
  5458.               2 - Write -  Opens a new file.  If the file exists, current
  5459.                            information will be erased.
  5460.               3 - Append -  Opens an existing file and places the file
  5461.                             pointer at end of file.
  5462.          Filename - Name of File, may include drive and path information
  5463.  
  5464.         Open a disk file which is to be read, written to, or appended.
  5465.         See {READ}, {WRITE}, {APPEND}, and {CLOSE} macro commands.
  5466.  
  5467.         As an example, {OPEN 1,3,"C:\DATA\TRIDATA.DTA"}{WRITE...} will
  5468.         open TRIDATA.DTA located in C:\DATA, which is to be appended.  If
  5469.         the file does not currently exist, it will be created.
  5470.  
  5471.         NOTE:  Any file which is opened with {OPEN}, must be closed with
  5472.                the {CLOSE} macro command before exiting from AS-
  5473.                EASY-AS.  Failure to do so will result in the file information
  5474.                becoming corrupted and unusable.
  5475.  
  5476.  
  5477.  
  5478.  
  5479.  
  5480.     {PICK Range,Outcell}
  5481.          Range   = Cell range which contains listing of labels to appear in
  5482.                    pick list.
  5483.          Outcell = Cell which will contain picked selection
  5484.  
  5485.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [93] 
  5486.         PICK will create a pick window comprised of the labels contained
  5487.         in the specified RANGE.  Using the cursor keys, the user can move
  5488.         through the list and highlight the desired label.  When [ENTER] is
  5489.         selected, the highlighted choice is placed in OUTCELL.
  5490.  
  5491.         PICK is useful for situations where the user is to be prompted for
  5492.         data input, and there is a limited selection of valid or desired
  5493.         responses.
  5494.  
  5495.         Example:
  5496.            {PICK A1..A10,C1}
  5497.            When an executing macro encounters this command, a pick window
  5498.            will appear in the top left of the screen which is comprised of
  5499.            the labels in the range A1..A10.  The user will select a label
  5500.            by pressing [ENTER] and the result be placed in cell C1.
  5501.  
  5502.  
  5503.     {QUIT}
  5504.         Stops execution of the macro and returns to the 'Ready' mode.
  5505.  
  5506.  
  5507.     {READ F#, CellAddress}
  5508.          F# - File Number (1, 2, 3, 4, or 5)
  5509.          CellAddress -  Worksheet cell location (column & row) where read
  5510.                         information is to be placed.
  5511.         Read one line from disk file #, from the current pointer location
  5512.         up to the carriage return, and place it in CellAddress.
  5513.         Subsequent {READ}s will continue to read in one line at a time,
  5514.         until the end of file is encountered.  At that point, execution
  5515.         will continue with the macro in the current cell, or if
  5516.         unsuccessful, the macro command in the next row. See {OPEN},
  5517.         {CLOSE}, {WRITE}, and {APPEND} macro commands.
  5518.  
  5519.         As an example, {READ 1, D10} will read a line of information from
  5520.         file #1 and place it in cell D10 of the worksheet.
  5521.  
  5522.     {RECALC Range}
  5523.         Calculates only the specified range.
  5524.  
  5525.  
  5526.     {RESTART}
  5527.         This command clears all levels of the subroutine stack and
  5528.         continues execution of the macro commands.  If {RESTART} is
  5529.         encountered, AS-EASY-AS continues with the instructions that
  5530.         follow.  Upon completion of the subroutine, it will terminate and
  5531.         WILL NOT return to the calling routine.
  5532.  
  5533.  
  5534.     {RET}
  5535.         When this command is encountered, execution is returned to the
  5536.         cell just below the last {CALL} command, i.e., to the macro that
  5537.         called the subroutine terminated with {RET}.  If no {CALL} command
  5538.         exists, and a {RET} command is encountered, a macro error occurs.
  5539.  
  5540.  
  5541.  
  5542.  
  5543.  
  5544.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [94] 
  5545.     {SCRNOFF}
  5546.         Disables the update of the screen.  Invoking this macro command
  5547.         will speed the operation of most of your macros since screen I/O
  5548.         is time consuming.  Remember to restore screen update after your
  5549.         macro is completed.
  5550.  
  5551.         NOTE:  When this macro is used, it will seem that your
  5552.                computer is not doing anything, i.e., the screen will not
  5553.                be updated until {SCRNON} and {UPDATE} macros
  5554.                are executed.
  5555.  
  5556.  
  5557.     {SCRNON}
  5558.         Enables the update of the screen.  This command should be invoked
  5559.         at the end of a macro that used {SCRNOFF}.
  5560.  
  5561.  
  5562.     {TONE  A1,A2}
  5563.         Generates a sound of frequency A1 (Hz) and duration A2 (milli-
  5564.         seconds). A1 and A2 can be values, results of a calculation or
  5565.         cell references.  This macro can also be used to cause a delay in
  5566.         macro execution without generating an audible tone, if desired.
  5567.  
  5568.          i.e. {TONE 0,5000} will create a silent delay of 5 seconds.
  5569.  
  5570.  
  5571.     {UPDATE}
  5572.         Refreshes the screen.  Useful after a {SCRNON} command.
  5573.  
  5574.  
  5575.     {WHILE Test,Action}
  5576.         Perform a subroutine call to the "Action" while the "Test" is
  5577.         true.  The subroutine must have a corresponding {RET} statement.
  5578.         Once the result of "Test" is false, continue execution of the
  5579.         macro command in the cell below.
  5580.  
  5581.  
  5582.     {WRITE "String"}
  5583.         Print the content of 'String' at the current character cursor
  5584.         screen coordinates, and leave the cursor at the end of the printed
  5585.         string.  It should be noted that this is only a temporary screen
  5586.         write.  If this was the last macro command in a sequence, it would
  5587.         disappear as soon as it was printed since the screen would be
  5588.         updated at the end of the macro sequence.
  5589.  
  5590.     {WRITE F#, "String"}
  5591.          F# - File Number (1, 2, 3,...)
  5592.          "String" -     Information to be written to the file.
  5593.  
  5594.         Writes "String" information to open disk file F#, starting from
  5595.         the current pointer location.  Subsequent {WRITE}s will continue
  5596.         to be appended to the file.
  5597.  
  5598.         If the {WRITE} fails, execution will continue with the macro
  5599.         command in the next row.  See {OPEN}, {CLOSE}, {READ}, and
  5600.         {APPEND} macro commands.
  5601.  
  5602.  
  5603.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [95] 
  5604.         As an example, {WRITE 1, "Test Data"} will write the string "Test
  5605.         Data" to file #1.
  5606.  
  5607.  
  5608.     {WRITELN "String"}
  5609.         Same as the {WRITE} macro, above, but places the cursor at the
  5610.         beginning of the next character row.
  5611.  
  5612.  
  5613.     {WRITELN F#, "String"}
  5614.         Same as the {WRITE F#, "String"} macro above, but writes String
  5615.         information to the file, starting from the current pointer
  5616.         location, as a single line, followed by carriage return and line
  5617.         feed characters.
  5618.  
  5619.  
  5620.  
  5621.  
  5622.  
  5623.  
  5624.  
  5625.  
  5626.  
  5627.  
  5628.  
  5629.  
  5630.  
  5631.  
  5632.  
  5633.  
  5634.  
  5635.  
  5636.  
  5637.  
  5638.  
  5639.  
  5640.  
  5641.  
  5642.  
  5643.  
  5644.  
  5645.  
  5646.  
  5647.  
  5648.  
  5649.  
  5650.  
  5651.  
  5652.  
  5653.  
  5654.  
  5655.  
  5656.  
  5657.  
  5658.  
  5659.  
  5660.  
  5661.  
  5662.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [96] 
  5663.     INDEX
  5664.     ~~~~~
  5665.  
  5666.        ABSOLUTE ADDRESS       26            F1                     17
  5667.        ABSOLUTE ADDRESS KEY   19            F1                     18
  5668.        ARROW KEYS             13            F2                     18
  5669.        ASEASY.PRT FILE        39            F3                     18
  5670.        ASEASY.PRT FILE        40            F4                     19
  5671.        AT&T MONOCHROME        10            F5                     19
  5672.        AUTOEXEC MACRO         83            F6                     19
  5673.        AUTOLOAD               10            F7                     19
  5674.                                             F9                     19
  5675.        BOX CHARACTERS         22            FORMAT                 26
  5676.                                             FORMULAS               23
  5677.        CALCULATE KEY          19            FORMULAS - POINTING    23
  5678.        CGA MODE               11            FORMULAS - TYPING      23
  5679.        CIRCULAR REFERENCES    30
  5680.        COMBINING WORKSHEETS   32            GOALSEEKING            51
  5681.        CONDENSED PRINT        35            GOTO KEY               19
  5682.        COPY FORMULAS          28            GRAPH COMBINING TEXT/GRAPHICS   46
  5683.        COPY VALUES            28            GRAPH FONT             43
  5684.        CURSOR                 87            GRAPH FORMAT           42
  5685.        CURSOR KEY             16            GRAPH MERGE            46
  5686.                                             GRAPH NAME             44
  5687.        DATA BIN               50            GRAPH OPTIONS          43
  5688.        DATA COMMANDS          48            GRAPH PLOT             45
  5689.        DATA DISTRIBUTION      50            GRAPH RANGES           42
  5690.        DATA FILL              48            GRAPH SAVE             46
  5691.        DATA INPUT             48            GRAPH TITLES           43
  5692.        DATA INPUT FORM        52            GRAPHICS               42
  5693.        DATA REGRESSION        51            GRAPHICS CHARACTERS    22
  5694.        DATA SORT              49
  5695.        DATABASE               54            HARDWARE                7
  5696.        DATABASE RANGE         54            HELP                   17
  5697.        DATING A PAGE          37            HERCULES               11
  5698.        DEFAULT DIRECTORY      10
  5699.        DISTRIBUTION OF DATA   50            INPUT FORM             52
  5700.        DOS VERSION             7            INSTALLATION            8
  5701.        DOT MATRIX              7
  5702.        DOT MATRIX             36            KEYBOARD               16
  5703.        DOT MATRIX PRINTERS    42
  5704.                                             LABEL                  20
  5705.        EDIT                   22            LASERJET               42
  5706.        EDIT CELL              18            LASERJET PRINTERS      36
  5707.        EMBEDDED CODES         38            LSF                    51
  5708.        EMS                     7
  5709.        ENHANCED GRAPHICS ADAPTER   11       MACRO COMMANDS         86
  5710.        ENTERING A MACRO       17            MACRO DEFINITION       83
  5711.        ENTERING AN EQUATION   17            MACRO EXECUTION        84
  5712.        ENTERING FORMULAS      21            MACRO KEY              18
  5713.        ENVIRONMENT VARIABLE   12            MACRO KEYWORDS         85
  5714.        EXIT                   33            MACRO NAME             83
  5715.        EXPANDED MEMORY         7            MACROS                 83
  5716.        EXPANDED MEMORY        11            MATHEMATICAL OPERATORS   21
  5717.        EXPORTING              31            MATRIX OPERATIONS      56
  5718.        EXTRACT CRITERION      54            MEMORY                  7
  5719.                                             MENUS                  13
  5720.  
  5721.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [97] 
  5722.        MONITOR (EGA)           7                ROUND ABSOLUTE         11
  5723.        MONITOR (VGA)           7
  5724.        MONITOR HERCULES        7                SAVING A FILE          30
  5725.        MONITOR MONOCHROME      7                SCREEN BLANKING        10
  5726.        MONOCHROME (B&W)       11                SET ASEASY=            12
  5727.        MOUSE                   7                SMART CURSOR           17
  5728.        MOUSE                   8                SORTING DATA           49
  5729.        MOUSE POINTING         24                SPARSE MATRIX           7
  5730.        MOVE FORMULAS          29                STRING FUNCTIONS       58
  5731.        MOVE VALUES            28
  5732.                                                 USING PRINT VIEW       41
  5733.        NAMED GRAPH            44
  5734.        NAMED GRAPH            44                VALUE                  20
  5735.        NAMED GRAPH            45                VGA MONITOR/CARD       11
  5736.        NAMED GRAPH            46                VIEW KEY               19
  5737.        NAMED GRAPH            47                VIEWS                  15
  5738.        NAMED RANGE            32                VIRTUAL MEMORY          7
  5739.        NAMED RANGE            76                VIRTUAL MEMORY         11
  5740.        NAMED RANGE            84
  5741.        NAMED RANGES           18                WINDOW KEY             19
  5742.        NAMED RANGES           25                WINDOWS                15
  5743.        NAMED RANGES           27                WINDOWS 3.0             7
  5744.        NON-TURBO KEYBOARD     11
  5745.                                                #OR# & #AND# OPERATORS   71
  5746.        OPERATING SYSTEM        7
  5747.                                                @@                      58
  5748.        PAGE BREAKS            37               @ABS                    64
  5749.        PAGE FOOTERS           37               @ACOS                   64
  5750.        PAGE HEADERS           37               @ACOSH                  64
  5751.        PAGE LENGTH            35               @ASIN                   64
  5752.        PAGE LENGTH            35               @ASINH                  64
  5753.        PAGE NUMBERS           37               @ATAN                   64
  5754.        PIC FILE               42               @ATANH                  64
  5755.        PRINT CONTROL CODES    39               @AVG                    73
  5756.        PRINT ENHANCEMENT      40               @CASE                   76
  5757.        PRINT FILE             40               @CELL                   58
  5758.        PRINT MARGINS          35               @CELLPT                 58
  5759.        PRINT MENU             34               @CHR                    60
  5760.        PRINT TO A FILE        40               @COLS                   76
  5761.        PRINT TYPE             39               @COMB                   73
  5762.        PRINTER BORDERS        35               @COS                    65
  5763.        PRINTER CODE           39               @COSH                   65
  5764.        PRINTER CONTROL FILE   39               @COUNT                  73
  5765.        PRINTER ESCAPE CODE    39               @CSC                    65
  5766.        PRINTER SET-UP FILE    18               @CTERM                  67
  5767.        PRINTER SETUP CODE     18               @CTN                    65
  5768.        PRINTER SETUP FILE     18               @DATE                   80
  5769.        PRINTER SETUP STRINGS   18              @DATEVAL                80
  5770.        PRINTERS                7               @DAY                    80
  5771.        PRINTING               34               @DDB                    68
  5772.        PRINTING COMBINED TEXT/GRAPHICS   41    @ERR                    72
  5773.                                                @EXACT                  60
  5774.        RANGE                  25               @EXP                    65
  5775.        RECALCULATION          29               @FACT                   74
  5776.        REGRESSION             51               @FALSE                  65
  5777.        RELATIVE ADDRESS       26               @FIND                   60
  5778.        RETRIEVING A FILE      32               @FV                     68
  5779.  
  5780.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [98] 
  5781.       @GAMMALN                65              @TAN                    67
  5782.       @HOUR                   80              @TANH                   67
  5783.       @HTABLE                 76              @TERM                   70
  5784.       @HTERP                  77              @TIME                   81
  5785.       @IF                     71              @TIMEVAL                81
  5786.       @INDEX                  77              @TODAY                  82
  5787.       @INT                    65              @TRIM                   62
  5788.       @IRR                    68              @TRUE                   67
  5789.       @ISERR                  72              @UPPER                  62
  5790.       @ISNA                   72              @USER                   78
  5791.       @ISNUM                  71              @VAL                    63
  5792.       @ISSTR                  72              @VAR                    76
  5793.       @LEFT                   60              @VTABLE                 79
  5794.       @LENGTH                 60              @VTERP                  79
  5795.       @LENGTH                 78              @YEAR                   82
  5796.       @LINK                   78
  5797.       @LN                     66              {APPEND F#, "FILENAME"}   86
  5798.       @LOG                    66              {BEEP X}                86
  5799.       @LOWER                  61              {BLANK RANGE}           86
  5800.       @MAX                    74              {BORDEROFF}             86
  5801.       @MID                    61              {BORDERON}              87
  5802.       @MIN                    74              {CALL LOCATION}         87
  5803.       @MINUTE                 81              {CLOSE F#}              87
  5804.       @MOD(X,Y)               66              {CLRSCR}                87
  5805.       @MONTH                  81              {DELAY X}               88
  5806.       @N                      61              {ESCON} AND {ESCOFF}    88
  5807.       @NA                     66              {EXIT}                  88
  5808.       @NOT                    72              {FOR .............}   88
  5809.       @NPV                    69              {GET CELL}              89
  5810.       @ORD                    61              {GOTOXY A1,A2}          89
  5811.       @PERM                   74              {IF CONDITION}ACTION...   89
  5812.       @PI                     66              {INDXY M,N}             89
  5813.       @PMT                    69              {INKEY CELL}            90
  5814.       @PROPER                 61              {INLABEL ............}   90
  5815.       @PV                     69              {INRANGE ............}   90
  5816.       @QMAX                   74              {INVALUE ............}   90
  5817.       @QMIN                   75              {IOINIT  ..............}   90
  5818.       @QSTD                   75              {IOLABEL "STRING",RANGE}   91
  5819.       @QSUM                   75              {IOVALUE "STRING",RANGE}   91
  5820.       @QVAR                   75              {JUMP LOCATION}         91
  5821.       @RAND                   66              {LET A1,EXPRESSION}     92
  5822.       @RATE                   69              {MENUCALL LOCATION}     92
  5823.       @REPEAT                 61              {MENUJUMP LOCATION}     92
  5824.       @RIGHT                  62              {MENUOFF}               93
  5825.       @ROUND(X,Y)             66              {MENUON}                93
  5826.       @ROWS                   78              {MENUWIDTH X}           93
  5827.       @S                      62              {MENUXY X,Y}            93
  5828.       @SEC                    66              {OPEN F#,M#,"FILENAME"}   93
  5829.       @SECOND                 81              {PICK RANGE,OUTCELL}    93
  5830.       @SIN                    66              {QUIT}                  94
  5831.       @SINH                   67              {READ F#, CELLADDRESS}   94
  5832.       @SLN                    70              {RECALC RANGE}          94
  5833.       @SQRT(X)                67              {RESTART}               94
  5834.       @STD(RANGE)             75              {RET}                   94
  5835.       @STR                    62              {SCRNOFF}               95
  5836.       @SUM                    76              {SCRNON}                95
  5837.       @SYD                    70              {TONE  A1,A2}           95
  5838.  
  5839.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [99] 
  5840.       {UPDATE}                95
  5841.       {WHILE TEST,ACTION}     95
  5842.       {WRITE "STRING"}        95
  5843.       {WRITE F#, "STRING"}    95
  5844.       {WRITELN "STRING"}      96
  5845.       {WRITELN F#, "STRING"}   96
  5846.  
  5847.       {?}                       86
  5848.  
  5849.  
  5850.  
  5851.  
  5852.  
  5853.  
  5854.  
  5855.  
  5856.  
  5857.  
  5858.  
  5859.  
  5860.  
  5861.  
  5862.  
  5863.  
  5864.  
  5865.  
  5866.  
  5867.  
  5868.  
  5869.  
  5870.  
  5871.  
  5872.  
  5873.  
  5874.  
  5875.  
  5876.  
  5877.  
  5878.  
  5879.  
  5880.  
  5881.  
  5882.  
  5883.  
  5884.  
  5885.  
  5886.  
  5887.  
  5888.  
  5889.  
  5890.  
  5891.  
  5892.  
  5893.  
  5894.  
  5895.  
  5896.  
  5897.  
  5898.     AS-EASY-AS User's Guide - Copyright 1992, TRIUS, Inc.              [100] 
  5899.  
  5900.  
  5901.